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Section 1 



INTRODUCTION 



The TEKTRONIX 41 05 Computer Display Terminal is a color 
graphics and text editing terminal that lets you display 
graphics as well as use a variety of text editors. 



THE MANUAL PACKAGE 

This manual contains the reference information needed to 
develop and maintain applications software for the 
TEKTRONIX 41 05 Computer Display Terminal. 

Related manuals include: 

• The 4105 Computer Display Terminal Operators 
Manual, which describes the terminal, its use, and the 
self-test features. 

• The 4105 Computer Display Terminal Reference Guide, 
which contains essential reference material in a con- 
densed form. 



• Section 4, Screen Editor Support, discusses text editing 
concepts. This section also contains detailed command 
descriptions for the ANSI X3.64 and VT52 text editing 
commands. If you are not familiar with this terminal, be 
sure to read the Syntax Conventions portion of this sec- 
tion; it will help u ou to better understand the command 
descriptions that follow in this section. 

• Section 5, 4100-Style Commands, Reports, and Parame- 
ter Types, contains an alphabetically organized dic- 
tionary of all the terminal commands except ANSI X3.64 
commands. If you are not familiar with this terminal, be 
sure to read the "Command Conventions" portion of this 
section; it will help you to better understand the com- 
mand descriptions that follow in this section. 

• Appendices include an ASCII Chart, Alternate Character 
Sets, Error Codes, Parameter Default Values, the 
Tektronix Color Standard, Examples of Integer Parame- 
ters, a glossary, and an index. 



WHERE TO LOOK FOR INFORMATION 



FEATURES 



This manual is organized as follows: 

• Section 1 , Introduction, contains introductory informa- 
tion about the terminal and tells you where to look for 
more information. 

• Section 2, Communications, discusses the concepts of 
terminal communications with the host computer. Topics 
discussed are reports, communications settings, and 
handshaking protocols. 

• Section 3, The Graphics Terminal, discusses controlling 
the keyboard and display from the applications program, 
graphic input and output, and using the color display. 



The following paragraphs describe some of the terminal's 
features. 

Color. You can select from a palette of 64 colors, with up to 
eight different colors displayed in the graphics area and an 
additional eight colors in the dialog area at one time. Use 
color to highlight lines, panels, and text. 

Graphics. You can draw solid or dashed lines in color. You 
can fill panels with solid colors, color shading, or with a vari- 
ety of patterns. You can add labels or text to the graphics in 
different sizes, colors, and rotation angles. 

Graphic Input. You can use most graphic input application 
programs written for Tektronix 401 Series terminals with- 
out modification. 
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Alphanumerics. You can display uppercase and lowercase 
characters. The characters have definable attributes, 
including character color, background character cell color, 
underline, and blink. The characters are displayed in 5-by-7 
dot matrices in a 6-by-1 2 dot character cell. 

Alternate Character Sets. You can select from eight alter- 
nate character sets: ASCII, United Kingdom, French, Swed- 
ish, Danish/Norwegian, German, a special supplementary 
character set, and a special rulings character set. 

The Dialog Area. The terminal includes a user-definable 
dialog area that lets you display host communications with- 
out interfering with the graphics on the screen. You can 
select a column width of 80 or 132 characters and you can 
adjust the area height from 2 to 30 lines. The dialog area's 
scrollable memory is adjustable from two to as many lines 
as there is memory available. The visibility of the dialog 
area can be controlled with the Dialog key (toggles between 
visible and not visible). 

Nonvolatile Memory. This portion of the terminal's memory 
lets you configure the terminal for a particular application 
and then save the operating parameters in a part of the ter- 
minal's memory that is not erased even when the power is 
turned off. When you turn the power on again, the terminal 
automatically uses the saved parameter values. 

Commands. The terminal has three types of commands. 
The first type lets you produce color graphics and control 
and program the keyboard and display; these commands 
are compatible with Tektronix 4010 Series graphics applica- 
tions programs. The second type of command lets you 
insert, delete, and erase characters and lines and to other- 
wise manipulate text in the dialog area; the terminal is com- 
patible with screen editors that transmit ANSI X3.64 
commands or VT52 commands (commands that follow the 
VT52 command syntax). The third type lets you enter 
English-style terminal control commands from the keyboard 
while in Setup mode. 



Computer Interface. The terminal uses a full-duplex serial 
RS-232-C interface with data rates to 38400 baud. 

Software Compatibility. The following software packages 
are compatible with this terminal: 

• Existing programs written for 401 Series terminals 

• TEKTRONIX PLOT 1 Interactive Graphics Library 

• TEKTRONIX PLOT 10 Easy Graphing II 

• SASGRAPH, from the SAS Institute, Inc 

• DISSPLA, from ISSCO (Integrated Software Systems 
Corporation) 

• Certain editors designed for use with VT1 00 terminals, 
such as EDT, VI, and EMACS 

Color Hardcopy. The terminal is compatible with the 
TEKTRONIX 4695 Color Graphics Copier. 

Keyboard. The terminal has a low-profile detachable key- 
board. The keys include ASCII uppercase, lowercase, and 
control characters; BREAK and ERASE keys; a 14-key 
numeric keypad; and four special function keys and eight 
programmable function keys. Most keys have N-key rol- 
lover. All keys are programmable except SHIFT, CTRL, and 
CAPS LOCK and you can set MOST keys to repeat when 
held down for more than one-half second. 

The Display. The terminal incorporates a 60-Hz non-inter- 
laced raster-scan display. The color CRT has 480-by-360 
pixel resolution. 
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THE TERMINAL'S PROGRAMMING 
MODEL 

You can configure the terminal to perform many different 
functions. Once you've set the operating parameters or 
characteristics of the terminal to best perform the desired 
function, you can save these parameters in the terminal's 
memory so that they are not erased when the terminal is 
turned off. In this way, the terminal can remain in the same 
configuration for as long as you want. 

This terminal is really two different terminals in one 
package: 

• A graphics display terminal that is compatible with 
Tektronix 4010 Series graphics applications programs. It 
also has an interactive color interface (used to adjust the 
terminal's color map or displayed colors), a scrollable 
dialog area for host communications while displaying 
graphics information, and a subset of the Tektronix 41 10 
Series command set. 

• A text entry and editing terminal that is compatible with 
both the American National Standards Institute (ANSI) 
X3.64 and the International Organization for Standard- 
ization (ISO) 6429 standards, and VT52-style com- 
mands. These standards define a set of terminal 
functions that let you manipulate and edit computer text 
files. You can configure the terminal to run most popular 
screen editors. 



Modes of Operation 

The terminal has four major modes of operation: 

• Ansi mode. In this mode, the terminal understands the 
syntax of the ANSI X3.64 text editing commands only. 
One specific implementation of Ansi mode is Edit mode, 
in which the operating characteristics of the terminal 
have been set to specific values. The Screen Editor Sup- 
port section of this manual contains a discussion of Ansi 
and Edit modes, and the descriptions of the ANSI com- 
mands. 

• Tek mode. In this mode, the terminal understands the 
syntax of the graphics and terminal control commands. 
The Graphics Terminal and 4100-Style Commands, 
Reports, and Parameter Types sections of this manual 
contain discussions of this mode and descriptions of the 
commands available in this mode. For added versatility, 
the parameters set in Tek mode carry over appropriately 
into Ansi mode. 



• VT52 mode. In this mode, the terminal is compatible 
with programs using VT52-style commands. 

• Setup mode. In this mode, the terminal accepts Setup 
mode commands, which the user enters from the termi- 
nal keyboard. The Graphics Terminal and 4100-Style 
Commands, Reports, and Parameter Types sections of 
this manual contain a discussion of this mode and 
descriptions of the commands available in this mode. 

The terminal also has many different submodes that let you 
perform different functions. Figure 1-1 shows the relation- 
ship of these submodes to the four ma'or modes. 



Terminal Commands 

The terminal can accept four different types of commands, 
each with its own syntax. Commands can only be executed 
in the terminal mode to which they belong. 

• Setup mode commands. These commands must be 
typed on the keyboard while in Setup mode. Setup mode 
commands have English-style names and parameters. 
For example: CODE TEK is the Setup mode command 
entered to select Tek mode. 

• Ansi mode commands. These commands are used for 
text editing. These commands can only be entered with 
the terminal in Ansi mode. You can type these com- 
mands on the keyboard. For example: E cM is the ANSI 
command that performs a reverse index function, and 
E c[5B is the Ansi mode command that moves the alpha 
cursor 5 lines toward the bottom of the screen. Some of 
these commands also have equivalent commands in 
Setup mode. 

• 41 00-Style (Tek mode) commands. These commands 
are used for graphics and terminal control. This class of 
commands lets you display graphic information on the 
screen and control the terminal. You can enter these 
commands on the keyboard, and they can only be 
entered with the terminal in Tek mode. Most of these 
commands also have equivalent commands in Setup 
mode. For example: E cLL5 (DALINES5 in Setup 
mode) is the 41 00-style command that sets five visible 
lines in the dialog area. 

• VT52 commands. These commands are used for text 
editing and can only be entered with the terminal in 
VT52 mode. 
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Tek mode - 



Setup mode- 



r 



Ansi mode_ 
Edit mode 



All Tek mode commands 
Alpha mode 
Vector mode 
Marker mode 
Graphic input mode 
Interactive Color mode 



All Setup mode commands 
Interactive Color Interface 



All Ansi mode commands 
Origin mode 
Insert/Replace mode 
Linefeed/Newline mode 
Overstrike/Replace mode 
Autowrap mode 
Autorepeat mode 
Cursor Key mode 
Keypad mode 
Interactive Color mode 



VT52 mode- 



All VT52 mode commands 
Graphics mode 
Keypad mode 



Figure 1-1. Terminal Modes. 
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COMMUNICATIONS 



This section explains communication between the terminal 
and a host computer. The topics covered are: 

• Communications Settings 

• The Communications Input Queue and Handshaking 

• Requesting Reports From the Terminal 



COMMUNICATIONS SETTINGS 

This subsection explains: 

• How to set the terminal's standard communication 
settings 

• How to use full-duplex communications 

You can set all of the terminal communications settings by 
sending commands from the applications program, or the 
operator can set them by typing Setup mode commands on 
the keyboard. These settings can be saved in the terminal's 
nonvolatile memory and remembered even if the terminal is 
turned off. 

The following paragraphs contain an explanation of each 
communication setting and the name of the command used 
to change the setting. 



TRANSMIT RATE LIMITS 

You can specify a transmit data-rate limit — a maximum 
speed for terminal-to-host communications — that is less 
than the rate at which the terminal sends each individual 
character. A transmit data rate limit of 300, for instance, 
means that the terminal, in sending characters to the host, 
will space those characters apart for an average data rate of 
300 bits per second. This limit is useful at high terminal-to- 
host baud rates, where the host computer's input processor 
can't accept characters at the full data rate. Use the SET 
TRANSMIT RATE LIMIT command to set this limit. 



SET ECHO 

Except in Setup mode, when you type on the terminal's key- 
board, the characters go to the host. They do not necessar- 
ily appear on the terminal's screen. They only appear on the 
screen if (1) the host (or modem) sends the same characters 
back to the terminal — provides a remote echo — or (2) the 
terminal provides its own local echo of the transmitted 
characters. 

The operator can specify whether the terminal provides a 
local echo by using the ECHO command in Setup mode. 
The SET ECHO command can also be issued by the host. 



BAUD RATES 

You can set the terminal's host-to-terminal and terminal-to- 
host data transmission baud rates with the SET BAUD 
RATES command. The term baud rate refers to the rate (in 
bits per second) that the terminal transmits or receives data. 
Normally, the operator sets these rates using the Setup 
command BAUD; however, you can issue a SET BAUD 
RATES command from the host. 

Communications with the host cannot take place unless the 
terminal's baud rates are correctly set. 
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FULL-DUPLEX DATA COMMUNICATIONS 



STOP BITS 



The terminal uses full-duplex data communications. To use 
full-duplex data communications with remote echo, the ter- 
minal's local echo must be turned off. (Enter an ECHO NO 
command in Setup mode.) 



PARITY 

The terminal's parity setting controls how the terminal sets 
the eighth bit (parity bit) in each character it sends to the 
host. Table 2-1 shows the possible parity settings and how 
they work. 



Table 2-1 
PARITY BIT DESCRIPTION 



Parity 


Description 


Low Parity 


When the terminal sends a character to the 
host, it sets the parity bit to 0. 


Odd Parity 


When sending a character to the host, the ter- 
minal sets the parity bit so that there are an odd 
number of 1 's in the character's eight bits. 


Even Parity 


When sending a character to the host, the ter- 
minal sets the parity bit so that there are an 
even number of 1 's in the character's eight 
data bits. 


High Parity 


Sets the parity bit to 1 in each character it trans- 
mits to the host. 


Data Parity 


The parity bit is used for encoding data, the 
same as are the other seven bits in each eight- 
bit character. Data parity is used in the terminal 
to send eight-bit data to the hardcopy unit. 



While communicating with the host, the terminal sends and 
receives each character serially, as a sequence of ten or 
eleven bits. This is called asynchronous serial data commun- 
ications. The first bit for each character is a start bit, always 
a (or space) bit. The next seven bits determine the particu- 
lar ASCII character, after which comes a parity bit, as 
described earlier. The character ends with one or two stop 
bits, which are always 1 (or mark) bits. The communications 
line then remains in the marking condition until the start bit 
for the next character is detected. 

While receiving characters from the host, the terminal will 
always respond, regardless of whether the host sends one 
or two stop bits in each character. 

While transmitting characters to the host, the terminal 
includes one or two stop bits in each character it transmits. 
Set the number of stop bits with the SET STOP BITS com- 
mand. 



BREAK TIME 

Pressing the BREAK key sends a break signal to the host. In 
full-duplex communications, the break sets the communica- 
tion line in a "space" condition for the length of the break. 

As shipped from the factory, the break signal is set to last 
200 milliseconds; this is adequate for most host computers 
(refer to your host's documentation to determine how the 
break signal is interpreted). The SET BREAK TIME com- 
mand lets you change this value for hosts for which 200 mil- 
liseconds is too short or too long. For hosts that do not 
accept break signals, you can set the break time to 0, 
disabling the break feature. 



The host can control the terminal's parity setting with the 
SET PARITY command. 
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COPING WITH °t FILLER CHARACTERS 



The Problem. Some host computers intersperse d t charac- 
ters (also known as Delete or Rubout characters) among the 
characters they send to a terminal. The host inserts these 
filler characters and the applications program has no con- 
trol over them. Since the terminal interprets d t as a valid 
character in integer and xy-coordinate parameters, these 
extra d t characters can cause problems. Integer and xy- 
coordinate parameters are described in the 4100-Style 
Commands, Reports, and Parameter Types section of this 
manual. 



The Remedy. The terminal includes two features that help 
solve this problem. First, the terminal accepts the two-char- 
acter sequence E c? as a synonym for d t. Second, the 
IGNORE DELETES command causes the terminal to ignore 
any d t characters that the host sends it. The terminal does 
not, however, ignore E c? sequences. 

Thus, if your host uses d t as a filler character, you should do 
the following two things: 

• Write your device driver routines so that they always 
send E c? when they would otherwise send the d t charac- 
ter. Change routines that issue integer and xy-coordi- 
nate parameters to output E c? instead of d t. 

• Execute an IGNORE DELETES command and then exe- 
cute the SAVE NONVOLATILE PARAMETERS com- 
mand to cause the terminal to remember this condition, 
even if it is turned off. 



THE COMMUNICATIONS INPUT 
PROTOCOLS 

THE INPUT QUEUE 

The terminal's input queue (or buffer) accumulates charac- 
ters received from the host. When characters arrive faster 
than the terminal can process them, the terminal stores 
them in its input queue until it has a chance to process 
them, or until the memory allocated for that queue is 
exhausted. (If the queue memory is exhausted, incoming 
characters are lost.) 

For instance, the terminal cannot display characters while it 
is erasing its screen. Therefore, while the screen is being 
erased (as, for instance, in response to the S Erase, 
D Erase, and G Erase keys), any characters coming from 
the host are stored in the input queue until the erase opera- 
tion is finished. When the screen erasure is complete, the 
terminal reads the characters from the queue and displays 
them. 

While in Setup mode, the terminal does not display charac- 
ters coming from the host. Instead, such characters accu- 
mulate in the input queue. The terminal waits to process 
those characters until the operator terminates Setup mode. 

As shipped from the factory, the input queue can hold up to 
300 ASCII characters; however, you can change this value 
with the SET QUEUE SIZE command. 



THE NEED FOR HANDSHAKING 

The terminal can display simple alphanumeric text and 
graphics only up to a maximum continuous data rate of 
1 9200 baud. At higher data rates, or for more complex oper- 
ations, use handshaking protocol to prevent the input queue 
from overflowing. Even at slow data rates, it may be prudent 
to use a handshaking protocol. 

You can simply issue a REPORT 401 STATUS command 
from time to time, and wait to receive the reply before send- 
ing more characters to the terminal. Alternatively, you can 
use Flagging mode or Prompt mode. The type of flagging 
you select depends on what your host supports. 
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Flagging 

Flagging is used to prevent the input queue from overflow- 
ing by allowing the terminal to start and stop transmissions. 
With flagging enabled, the data communications at high 
data rates can be accomplished without overflowing the 
input queue. 

Two types of flagging are available: DC1/DC3 software flag- 
ging and DTR/CTS hardware flagging. 



DC1/DC3 Flagging. DC1/DC3 flagging uses the transmis- 
sion or reception of the DC3 and DC1 control characters to 
inhibit or enable the transmitting device. DC3 is the stop 
character and DC1 is the start character. This allows you to 
use flagging with devices that do not have control of the RS- 
232-C DTR and CTS lines. Note that if a communications 
error causes a DC1 or DC3 character to be garbled in trans- 
mission, the handshake with the host computer may stop 
communications. 



DTR/CTS Flagging. In DTR/CTS flagging, the terminal indi- 
cates that it wants to transmit data by asserting RTS 
(Request To Send). If the host is ready to receive the data, it 
asserts CTS (Clear To Send). The terminal can transmit only 
when CTS is asserted. 

If the terminal transmits characters faster than the host can 
process them, the host can drop CTS. When the host is 
ready to receive more characters, it asserts CTS, and the 
terminal resumes its transmission. 

When receiving characters from the host, the terminal uses 
the DTR (Data Terminal Ready) signal line in the same way 
that the host uses the CTS line. If the host is sending char- 
acters faster than the terminal can process them, the termi- 
nal drops DTR. The host stops transmitting to the terminal. 
When the terminal is ready for more characters, it asserts 
DTR, and the host resumes its transmission to the terminal. 

You can set the terminal's Flagging mode using the SET 
FLAGGING MODE command. Alternatively, the operator 
can set Flagging mode using the Setup mode FLAGGING 
command (see the 4105 Computer Display Terminal 
Operator's Manual tor details). 



NOTE 

DTR/CTS flagging is usually not practical when the 
terminal is connected to the host with a telephone line 
modem. In such circumstances you should use 
DC1/DC3 flagging because the host does not have 
direct access to the DTR and CTS signal lines. 



Prompt Mode 

Prompt mode protocol is useful for preventing the host's 
input queue from overflowing when the terminal has too 
much data to send to the host. However, Prompt mode does 
not protect the terminal's input queue from overflowing 
when the host sends data to the terminal. For that, use 
Flagging mode. 



Prompt Mode Operation. When the terminal is in Prompt 
mode, it waits to send each line of text until it receives a 
prompt string from the host. The prompt string is a 
sequence of characters, determined by the most recent 
SET PROMPT STRING command. 

Upon receiving the prompt string, the terminal wafts for the 
transmit delay and then sends one line of text to the host. 
Here, one line of text means all the characters it has to 
send, up to and including the next EOM (End of Message) 
character or EOL (End of Line) string — usually c h. This is 
described in more detail later in this section. 

The prompt string must be the last characters the terminal 
receives, or the terminal will not recognize it as a prompt. 

The following steps summarize Prompt mode operation: 

1 . The terminal sends a line of text, up to and including 
the EOM character or EOL string that marks the end of 
the line. 

2. The terminal receives a prompt string from the host. 

3. The terminal waits for the transmit delay. 

4. Steps 1 through 3 are repeated again and again, until 
you terminate Prompt mode. 
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End of a Line of Text. As just mentioned, the end of a line of 
text occurs when the terminal encounters an EOM charac- 
ter or EOL string in the data it is sending to the host. The 
EOL strings are typically c r (carriage return) characters, 
although you can choose other characters or character 
sequences with the SET EOL STRING command. 



LINES OF TEXT AND THE TRANSMIT DELAY 

The preceding description of Prompt mode mentioned the 
concept of a line of text in data being transmitted to the 
host, and the transmit delay that occurs auer tiie terminal 
sends each such line of text. The following description 
explains these concepts in more detail. 



REQUESTING REPORTS FROM THE 
TERMINAL 

This subsection explains how you can request reports from 
the terminal. 

The applications program can cause the terminal to trans- 
mit reports by sending report commands. When the termi- 
nal receives one of these commands, it transmits a report 
containing the requested information back to the program. 
Each of these commands causes the terminal to send a par- 
ticular report. It is the program's responsibility to interpret 
these reports. The syntax of each report is explained in the 
4 100-Style Commands, Reports, and Parameter Types sec- 
tion of this manual. 



The Output Queue 

The terminal's output queue holds any characters that are 
waiting to be transmitted to the host. When the operator 
types on the keyboard, the characters he or she types go 
into the output queue. Likewise, when the terminal has a 
report message to send to the host, the characters of that 
message go into the output queue. 

The terminal sends the characters in the output queue to 
the host a line at a time; that is, it reads characters from the 
output queue and sends them to the host until it encounters 
the end of a line. Then it waits for a short time (the transmit 
delay) before sending the next line of text. If in Prompt 
mode, the terminal also waits to receive a prompt from the 
host before sending the next line of text. 

If there are no characters waiting in the output queue, then 
each character the operator types enters the output queue 
and is immediately sent to the host. (This is true even if the 
terminal is in Prompt mode.) Characters wait in the output 
queue only if the operator types faster than the terminal's 
transmit rate. When the operator presses RETURN, a c r 
goes into the output queue and is sent to the host. Since c r 
is the usual EOM character, this also marks the end of a line 
of text. The terminal then waits a short time before sending 
the next character typed. This transmit delay, however, is 
usually so short that it is imperceptible to the operator. 

A line of text means "all the characters waiting to be trans- 
mitted, up to and including the next EOM character or EOL 
string." As the terminal is shipped from the factory, its only 
EOM character is c r, and the EOL string consists of one 
character, c r. Thus, if the terminal is set as it is when 
shipped from the factory, a line of text means "all charac- 
ters waiting to be transmitted, up to and including the next 
c r character." 



The terminal ends each line of information in the report with 
an EOM character. The terminal actually substitutes its cur- 
rent EOL string for each EOM character that is sent. The 
default EOL string is c r, although other characters may be 
selected with the SET EOL STRING command. 



REPORT COMMANDS 

The following paragraphs contain a brief explanation of the 
five reports that you can request. 



Graphic Cursor Position. The 4010 GIN Report transmits 
the position of the graphic cursor to the host. This report is 
generated in response to an ENABLE 4010 GIN command, 
which allows the operator to position the graphic cursor and 
then press a key to transmit the coordinates of that iocation. 



Alphatext Cursor Position. The CPR (Cursor Position 
Report) reports the location of the Alphatext cursor in the 
dialog area. This report is generated in ANSI format in 
response to a DSR (Device Status Report) command. You 
must select Ansi mode (by using the SELECT CODE com- 
mand) before any DSR commands can be executed. The 
EOL string is not appended to the Cursor Position Report. 
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Terminal Settings. The Terminal Settings Report transmits 
the parameter values for the terminal setting to the host. 
The REPORT TERMINAL SETTINGS command causes the 
terminal to generate a Terminal Settings Report. The 
REPORT TERMINAL SETTINGS command allows you to 
use an inquiry-code parameter. You can enter the op-code 
for a particular command, and the Terminal Settings Report 
will report the values for that command. You can also enter 
special inquiry codes that report the current configuration of 
your terminal. 



Error Messages. The Error Message Report reports the 
eight most recently detected error codes, their severity 
level, and how many times each error code was detected. 
This report is generated by the REPORT ERRORS 
command. 



4010 Status. The 4010 Status Report reports the position of 
the graphic cursor. This report, when generated, terminates 
4010 GIN mode and the terminal is placed in Alpha mode. 
This report is generated by the REPORT 401 STATUS 
command. 

Each time one of these reports is generated (except for the 
Cursor Position Report), the terminal enters Bypass mode. 
In Bypass mode the terminal will not accept commands or 
any other host input except the bypass-cancel character. 
The terminal remains in Bypass mode until it receives the 
bypass-cancel character or the Cancel key is pressed. 
Refer to the 4100-Style Commands, Reports, and Parameter 
Types section of this manual for more information about the 
BYPASS CANCEL CHARACTER command. 
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THE GRAPHICS TERMINAL 



This section explains how to use the terminal for graphics 
display. Its principal topics are: 

• Using the Display — displaying graphics and the host- 
operator dialog. 
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the operator choose a position on the screen and then 
reports to the host what location was chosen. 

• Macros — character strings stored in the terminal that 
can be retrieved for a variety of applications. 

• Pixel Operations — the additional capabilities offered by 
the optional pixel ROM pair. 

While in Tek mode, the terminal responds to a full set of 
commands capable of creating graphics displays. In addi- 
tion, Tek mode lets both the host and operator use macros. 

To put the terminal in Tek mode, the host issues a SELECT 
CODE command that specifies Tek mode. The complete set 
of graphics commands is now available to the host. An oper- 
ator can use the graphics commands at any time, regard- 
less of whether the terminal is in Tek mode, by pressing the 
Setup key to put the terminal in Setup mode. 



USING THE DISPLAY 

The terminal displays two types of information: 

• Host-operator dialog 

• Graphics 

The host-operator dialog consists of messages from the 
host and the operator's responses. Graphics is the screen's 
pictorial information. Usually, a host program directs the two 
types of information to separate areas of the screen. The 
area of the screen where the host-operator dialog appears 
is the dialog area. The area where graphics is displayed is 
the graphics area. 

THE DIALOG AREA 

Think of the dialog area as a writing surface that sits in front 
of the graphics area. Unlike the graphics area, which 
always fills the entire screen, the dialog area can vary in 
size from two lines to the entire screen. As explained later 
under "Colors and Transparency," the dialog area need not 
completely cover the graphics area, and you can make the 
dialog area transparent. 
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Figure 3-1 . The Dialog Area and Buffer. 



4105 PROGRAMMERS 



REV, SEP 1983 



3-1 



THE GRAPHICS TERMINAL 



Either a host program or the operator can set the size of the 
dialog area by specifying the number of dialog lines. The 
operator uses the DALINES command; a host program uses 
the SET DIALOG AREA LINES command. Figure 3-1 shows 
a representation of the dialog area. 



Dialog Buffer 

The terminal can save more lines of dialog than what the 
dialog area shows. The saved lines, which include the lines 
displayed, are the dialog buffer. A host program sets the 
number of lines saved with the SET DIALOG AREA 
BUFFER SIZE command; the operator uses the Setup com- 
mand DABUFFER. The operator can scroll the lines of the 
dialog buffer, moving different portions of the dialog buffer 
into view (see Figure 3-1). 



Alphatext 

Alphatext is the type of text the terminal uses to display 
messages from the host. The normal mode for the terminal 
when it is not in Ansi mode is Alpha mode. In Alpha mode, 
the terminal displays all characters it receives from the host, 
unless the characters are a command to the tef minal. (The 
terminal can recognize commands from the host because 
they always begin with E c or a control character.) 



Enabling the Dialog Area 

When the dialog area is enabled, all alphatext is sent to the 
dialog buffer. When the dialog area is disabled, the terminal 
emulates a Tektronix 401 Series terminal, which does not 
have a dialog area — alphatext appears on the screen at 
locations determined by previous commands or display 
operations. A host program enables or disables the dialog 
area with the ENABLE DIALOG command; the operator 
uses the Setup command DAENABLE. 



Making the Dialog Area Visible 

The dialog area does not appear on the screen unless it is 
visible. If the dialog area is enabled, the dialog is saved in 
the dialog buffer; but dialog is not displayed unless the dia- 
log area is both enabled and visible. If the dialog area is 
enabled but invmoie, cnangmy n m dialog area to visible dis- 
plays dialog that accumulated while the dialog area was 
invisible. A host program sets dialog area visibility with SET 
DIALOG VISIBILITY; the operator uses the Setup command 
DAVISIBILITY 



Colors and Transparency 

The SET DIALOG AREA INDEX command (Setup com- 
mand DAINDEX) sets these colors in the dialog area: 

• Character color — the color for alphatext in the dialog 
area 

• Character background — the color of the cell surround- 
ing each character 

• Dialog background — the color of the dialog area before 
anything is written on it 

Figure 3-2 shows where the dialog area uses these colors. 

Both the dialog background and character background can 
be transparent. Graphics behind a transparent area can be 
seen. For example, when character background is transpar- 
ent, alphatext appears as if it is written on a piece of glass in 
front of the graphics. 

The details of specifying colors are explained later in this 
section. 



Dialog Area Commands 

Table 3-1 lists the commands that control the dialog area. 
Most of these commands can be either sent by the host or 
entered by the operator as a Setup command.. The SAVE 
NONVOl ATILE PARAMETERS command saves the set- 
tings made by these commands; tnese settings are then 
retained even when trie terminal is turned off. 



CHARACTER 
COLOR 

ABC 



DIALOG 
BACKGROUND 



CHARACTER 
BACKGROUND 



■-."( 'L 



Figure 3-2. Colors in the Dialog Area. 
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Table 3-1 
COMMANDS AFFECTING THE DIALOG AREA 



Host Command 


Setup 
Command 


Function 


ENABLE DIALOG AREA 


DAENABLE 


Directs alphatext to 
either dialog area or 
graphics area 


SET DIALOG AREA 

HI IPFPR QI7F 


DABUFFER 


Sets the maximum 
number of dialog 
lines the terminal 
remembers 


SET DIALOG AREA 
LINES 


DALINES 


Sets the maximum 
number of dialog lines 
visible at one time 


SET DIALOG AREA 
INDEX 


DAINDEX 


Sets color of dialog 
area background and 
text 


SET DIALOG AREA 
COLOR MAP 


DACMAP 


Defines the colors of 
the eight dialog area 
indices 


SET DIALOG AREA 
WRITING MODE 


DAMODE 


Sets space and under- 
score to either replace 
or overstrike other 
characters 


SET DIALOG AREA 
VISIBILITY 


DIVISIBILITY 


Makes dialog visible or 
invisible 


CLEAR DIALOG 
SCROLL 


CLEARDIALOG 
oTshift-D Eras 
key 


Deletes all dialog 



DISPLAYING GRAPHICS INFORMATION 

This discussion tells how a program can draw pictures in 
the graphics area. Subjects covered are: 

• Terminal Space. How to specify screen positions. 

• Windows. How to specify the region you want 
"displayed. 

• Lines. How to draw lines and how to make them solid, 
dashed, or colored. 

• Markers. How to mark screen positions with small 
symbols. 

• Panels. How to fill an area with a pattern or color. 

• Graphtext. How to put text in your pictures. 



Terminal Space 

Graphics are created on a conceptual two-dimensionai sur- 
face called terminal space. All or part of terminal space 
might be displayed in the graphics area depending on the 
window you display (windows are explained later in this 
section). 

Commands use terminal space coordinates to specify a loca- 
tion in terminal space. These coordinates are paired inte- 
gers; each integer pair specifies a single screen position. 
The first value in each pair is the x-coordinate and specifies 
how far left or right. The second value is the y-coordinate 
and specifies how far up or down. Figure 3-3 shows the 
positions of certain coordinate pairs. 

When you send terminal space coordinates to the 
terminal, they must be encoded in a special way. See 
"XY-Coordinates in Host Syntax" in Section 5 for instruc- 
tions. 

You can use any integer from through 4095 for either the 
x- or y-coordinate. This range covers the entire terminal 
space. Each unit in this coordinate system is a terminal 
space unit (TSU). 
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Figure 3-3. Terminal Space Coordinates. 
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Current Graphics Position. There is always one position in 
terminal space that is the current graphics position. This is 
often the position that was specified in the last graphics dis- 
play operation and is usually the default position the termi- 
nal uses when none is specified. When the terminal is first 
turned on, position (0,3071) is the current position. This 
position is called the home position and is near the upper- 
left corner of the screen when the factory default window is 
used. 



Windows 

A window is a rectangular area in terminal space that you 
specify that you want to fill the screen. Specify the coordi- 
nate of the lower-left and upper-right corners of the window 
with the SET WINDOW command. These positions are 
placed at the corresponding corners of the screen. The dis- 
play is linearly distorted unless the window has the 3:4 
aspect ratio of the screen. (Aspect ratio is the ratio of height 
to width.) Figure 3-4 shows different windows displaying the 
same terminal space. 
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Figure 3-4. Examples of Windows. 
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To ensure that the display is not distorted, specify only the 
height or width of the window and specify zero for the other 
dimension. The terminal automatically replaces the zero 
height or width with a value that maintains a proper aspect 
ratio. Since you specify the corners of a window with 
xy-coordinates, a zero width means you use the same 
x-coordinate for both corners. A zero height means you use 
the same y-coordinate for both corners. 

Since the terminal displays the dialog area in front of the 
graphics area, all or part of the window may be obscured by 
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this section, you can avoid obscuring the graphics area by 
issuing commands that make the dialog area invisible or 
transparent. 



Lines 

To draw lines, you can use either of two methods. One 
method uses a special mode, Vector mode, in which the ter- 
minal interprets messages from the host as encoded posi- 
tions for line segment endpoints. The other method uses 
MOVE and DRAW commands to create lines. 



At times, you might want to start a line at a new position 
without drawing a line to that position. (This is analogous to 
lifting the pen from the paper in a drawing and moving it to a 
new location.) To do this, send another ENTER VECTOR 
MODE command. A new line will be started at the next posi- 
tion you specify. 

At times, you might want to draw a line from the current 
position when the terminal is not yet in Vector mode. To do 
this, issue an ENTER VECTOR MODE command followed 
by the b l character. The terminal's bell sounds and a line will 

ha iHraw/n f rr\m tha r*i irront i-irteitirtn tr» tha npvt r\r*eitirtn \trn i 

specify. 



MOVEs and DRAWs. The MOVE-and-DRAW method of cre- 
ating lines uses individual commands to create lines. The 
terminal does not need to be in Vector mode to execute 
these commands. 

The MOVE command sets the current position, but does not 
draw a line to this position. The command's effect is analo- 
gous to lifting a pen from paper and placing it at a new posi- 
tion in a drawing. 



Vector Mode. The ENTER VECTOR MODE command puts 
the terminal in Vector mode. When in this mode, the termi- 
nal interprets all characters the host sends, except for char- 
acters forming commands, as xy-coordinates. (Commands 
all begin with E c or a control character.) The first coordinate 
pair specifies where the line starts. When the terminal 
receives a second coordinate pair, it draws a line to that 
position and makes it the current position. As the terminal 
receives subsequent coordinates, it draws a line from the 
current position to the specified position. This continues 
until the terminal leaves Vector mode. 



The DRAW command draws a line from the current position 
to the position specified in the DRAW command. The cur- 
rent position then becomes the position specified in the 
command. 

Figure 3-5 compares how a line is created using Vector 
mode and how it is created using MOVEs and DRAWs. 



4105 PROGRAMMERS 



REV, SEP 1983 



3-5 



THE GRAPHICS TERMINAL 



Line Attributes. Before drawing a line on the screen, you 
can set both a line style and a line index for the line. The 
seven available line styles are shown with the SET LINE 
STYLE command description. The line index determines 
the line's color. With the SET LINE INDEX command you 
can assign any of the available color indices to the line 
before drawing it. (Color indices are explained later in this 
section.) 



Markers 

A marker is a small, predefined symbol that marks a posi- 
tion in terminal space. Before displaying a marker, you can 
choose any of eleven marker types (shown in the descrip- 
tion of the SET MARKER TYPE command). You then use 
either of two methods to display markers. One method uses 
Marker mode. The other method uses an individual com- 
mand, MARKER, to create each marker. 



Marker Mode. The ENTER MARKER MODE command puts 

the terminal in Marker mode. The terminal then interprets all 

characters 

it receives, except for those in commands, to be 

xy-coordinates. It places a marker at each specified 

position. 

The only way to leave Marker mode is to issue the ENTER 
ALPHA MODE command. Alpha mode is the only mode you 
can enter directly from Marker mode. 



DRAW MARKER Command. The MARKER command spec- 
ifies a single position. The terminal displays, at the specified 
position, the type of marker selected in the most recent SET 
MARKER TYPE command. The terminal does not need to 
be in Marker mode when it executes the DRAW MARKER 
command. 



(1500,1500) (2500,1500) 




(1000,1000) (2000,1000) 



MOVE and DRAW Method 

Command Description After Encoding 



MOVE 1000,1000 
DRAW 1500,1500 
DRAW 2000,1000 
DRAW 2500,1500 



E cLF' x z'Z 
E cL6+ N w+W 
E cLG' ^z/T 
E cLG+ v w3Q 



Vector Mode Method 




Command Description 


After Encoding 


ENTER VECTOR MODE 


G s 


1000,1000 


' v z'Z 


1500,1500 


+ , w+W 


2000,1000 


' * z/T 


2500,1500 


+ 'w3Q 


ENTER ALPHA MODE 


u s 



4526-6A 



Figure 3-5. Two Methods for Displaying a Line. 
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Panels 

A panel is an area in terminal space that can be fiiieci with 
any of 148 predefined patterns. Figure 3-6 shows some 
of these patterns. 

To create a panel: 

1 . Send the SELECT FILL PATTERN command and spec- 
ify the fill pattern you want to use. See this command's 
description for the available choices. 

2. Send the BEGiN PANEL BOUNDARY command. This 
command specifies the position for the boundary line's 
starting position and sets whether the panel's boundary 
line should be displayed in the finished panel. 

3. Define the panel's boundary line. Do this in either of 
two ways: 

a. Put the terminal in Vector or Marker Mode and then 
send the coordinates of boundary segment end- 
points. 

b. Send MOVE and DRAW commands. 

You do not need to define the last segment that closes 
the panel. 

4. Send the END PANEL command. This automatically 
creates a boundary line segment back to the starting 
position and displays the panel with its fill pattern. The 
current position is set to the panel's starting position. 

If the terminal is in Marker mode during this process, 
markers are not displayed. 



If the terminal is in Vector mode, the boundary line is dis- 
played as the panel is created. Depending on the choice 
specified in the SEGIN PANEL BOUNDARY command, the 
boundary line is either displayed in the finished panel or 
covered by the fill pattern. 

If a panel's boundary crosses itself as in Figure 3-6C, the 
terminal uses this rule to determine which areas are inside 
the panel: If, starting from a point distant from the panel, 
you cross the boundary an odd number of times to get to the 
area, the area is inside the panel; if you cross the boundary 
an even number of times, the area is outside the panel. Only 
areas inside the pane! are filled. 

As shown in Figure 3-6B, a panel can have more than one 
boundary. To make such a panel, issue additional BEGIN 
PANEL BOUNDARY commands before ending the panel. 
When you issue an additional BEGIN PANEL BOUNDARY 
command, this closes the boundary being created and 
starts a new boundary at the specified position. The panel, 
defined by multiple boundaries, is not filled until the termi- 
nal receives the END PANEL command. 



Graphtext 

Graphtext is a special type of text for use in the graphics 
area. You should always use graphtext in the graphics area 
because of its versatility and because it leaves the dialog 
area undisturbed. Graphtext can be resized, rotated, and 
written in different directions. The terminal lets you put 
alphatext in the graphics area, but this feature is provided 
primarily for compatibility with Tektronix 401 Series 
terminals. 



A. Panel With 
One Boundary 



B. Panel With 
Two Boundaries 



C. Panel Whose 

Boundary Crosses Itself 





Figure 3-6. Examples of Panels. 
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Before you send the GRAPHIC TEXT command (the com- 
mand that displays graphtext), you can set several charac- 
teristics of graphtext with other commands. See Figure 3-7 
for a list of these commands and examples. 

Only printable characters can be in the string you specify as 
graphtext. This includes the ASCII characters s p through ~ 
(ASCII decimal equivalents 32 through 126). The terminal 
generates an error for characters outside this range. 



COLOR DISPLAY 

When a command specifies the color of something on the 
screen, it does not state an absolute color, such as light- 
green or bluish-grey. Instead, it specifies an integer called a 
color index. Either a host program or the operator can select 
the color a particular color index is associated with. For 
example, when the terminal is shipped from the factory, 
Color Index 2 is set to mean "red"; so, anything you assign 
to Index 2 is displayed in red. If you then change Index 2's 
definition to "blue", anything displayed in Index 2 is blue. 



Color Indices 

A color index must be an integer in the range through 7. 
Since all graphics area colors are specified with color indi- 
ces, you can use eight different colors in the graphics area 
at any one time. The dialog area has its own set of eight 
color indices. 

The color a color index produces can be set in several ways. 
When the terminal is shipped from the factory, the color indi- 
ces are assigned default colors. A host program can assign 
colors with the SET SURFACE COLOR MAP command and 
the SET DIALOG AREA COLOR MAP command. The oper- 
ator can assign colors with the color interface (see the 4105 
Operators Manual), the CMAP Setup command, and the 
DACMAP Setup command. 

The SAVE NONVOLATILE PARAMETERS command saves 
the settings for indices so that they are retained even when 
the terminal is turned off. 

Colors for color indices are defined by three characteristics: 
hue, lightness, and saturation. Each of these characteristics 
is identified by an integer. See the color cone in Appendix F 
for an illustration of these characteristics. Note that insuffi- 
cient saturation and extreme values for lightness can 
obscure colors. 



Characteristic Command 


Examples 






Rotation SET GRAPHTEXT ROTATION 


o 




X 




X ABC § 


oay x 


3> 

00 




X 




o 




QO g O 


180° 


270° 




Character Path is RIGHT in all 


examples. 




Character Path SET CHARACTER PATH 


c 




x 

A 




X ABC B 


CBA X 


B 




A 








X 




C 




Right Up 


Left 


Down 




Rotation = 0° in all examples. 






Character Size SET GRAPHTEXT SIZE 


Height { ABC 
Width 






Note: x indicates current graphics position. 






4526-8B 



Figure 3-7. Graphtext Characteristics. 
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Dither Patterns 



or nsift/yrr? 



is, 



A predefined set of pane! fi!! patterns, called dither patt 
mimic colors by displaying patterns of adjacent different- 
colored pixels. (A pixel is the smallest display element.) The 
pattern of different-colored pixels looks like a solid color. 
The dither patterns are identified by fill patterns 50 through 
174. 



Using Colors 

To color objects on a display, you simply use commands to 
assign a color index to each object. For lines, set the color 
index with SET LINE INDEX before creating the line. For 
panels, use SELECT FILL PATTERN to choose either a solid 
color (identified by a color index) or another pattern. For text 
in the graphics area, use SET TEXT INDEX before creating 
the text. The SET DIALOG AREA INDEX command sets the 
color of text in the dialog area, character background, and 
dialog area background. 

Assigning a new color to a color index immediately changes 
the color of all items assigned to that color index. 



Effective Color Displays 

Color is effective for: 

• Separating categories of information 

• Helping the operator locate a particular object in a 
cluttered display 

• Cuing the operator that information has changed 

• Making small symbols (such as markers) more obvious 

Before assigning colors, first consider how the operator will 
use the display and then decide whether color will be help- 
ful. In an uncluttered, structured display, color adds little to 
the operator's understanding. As the number of colors 
increases, the operator time required to respond to any one 
color increases. The chance for confusion among colors 
also increases. 



Keep these points in mind when assigning colors: 

• The four most useful colors are red, green, yellow, and 
blue, if you need additional colors, use orange, yellow- 
green, blue-green, and violet. 

• Blue text and symbols are harder to read than text and 
symbols in other colors. (Blue is easier to see when its 
lightness level is greater than 50%.) 

• Use the same color the same way in different displays; 
this creates easier and quicker recognition of the color's 
use. 



GRAPHICS INPUT 

Graphics Input (GIN) mode allows an operator to "point" to 
a graphics location on the terminal's display. In GIN mode, 
when the operator presses a key, the terminal sends the 
xy-coordinates of the desired location to the host. 

Some commands used in GIN mode have "401 0" in their 
title. This indicates that these commands originated in Tek- 
tronix 4010 Series terminals and differentiates the com- 
mands from input commands used by other Tektronix 
terminals. 

These steps describe what typically happens in GIN mode: 

1 . The host sends an ENABLE 401 GIN command to the 
terminal. The terminal is now in GIN mode. 

2. The terminal displays the graphic cursor and the opera- 
tor moves the cursor to the desired position by pressing 
the joydisk. 

3. The operator presses any key that normally produces a 
character. 

4. The terminal sends a 4010 GIN REPORT to the host. 
This report tells which key the operator pressed and the 
xy-coordinates of the graphics cursor. 

5. The graphics cursor location becomes the current posi- 
tion and the terminal enters Alpha mode. 
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If the dialog area is not enabled, the alphatext cursor is set 
to the graphics cursor position. 

If the dialog area is enabled, the terminal ignores the PAGE 
command and the c r character while in GIN mode. Pressing 
the G Eras key with the dialog area enabled erases the 
graphics area, but leaves the terminal in GIN mode. If the 
dialog area is not enabled, the G Eras key, PAGE command, 
or c r character terminate GIN mode and put the terminal in 
Alpha mode; no report is sent to the host. 

While the terminal is sending a report to the host, the termi- 
nal is in Bypass mode. While in this mode, the terminal 
ignores input from the host. After the message is sent, the 
terminal returns to Alpha mode. (Bypass mode is explained 
in the Communications section.) 

If a program needs the current position of the graphics cur- 
sor, but does not want to give the operator the opportunity to 
move the graphics cursor, it sends the REPORT 401 STA- 
TUS command. The terminal reports the xy-coordinates of 
the graphics cursor immediately without giving the operator 
the chance to move the cursor. 



Macros are also used another way. Each key or key combi- 
nation indicates a particular macro number (details are 
explained later in this discussion). If a macro is defined for a 
key's macro number, when the operator presses that key, 
the terminal looks up the macro and uses the string of char- 
acters it finds instead of the character the key normally pro- 
duces. A macro that can be expanded by pressing a key is 
called a key macro. 



HOST MACROS 

Host macros are the group of macros that can be expanded 
only in the EXPAND MACRO command. If the macro is a 
terminal command, when the macro is expanded, the termi- 
nal executes the command. If the macro is not a command, 
it is displayed on the screen, just like any message from the 
host. 

Macros are efficient in many operations. For example, 
instead of sending a long string of characters, the host can 
send the much shorter EXPAND MACRO command. This 
saves data transmission time and ensures that the terminal 
receives the same string each time a particular macro is 
specified. 



MACROS 

A macro is a string of characters identified by an integer 
called the macro number. Either the host or the operator 
can assign a string to a macro number with the DEFINE 
MACRO command. The terminal then stores the macro 
along with its identifying macro number. 

After a macro is defined, a host program or an operator can 
issue an EXPAND MACRO command, which specifies a 
macro number. The terminal looks up the macro assigned to 
that macro number and uses that string. This process of 
looking up a macro number and using the stored macro is 
called expanding a macro. 

For example, a host program can define macro 301 to be 
the string "Type any key to continue." Then, anytime the 
program needs this string displayed, instead of sending the 
entire message, it could just issue the terminal an EXPAND 
MACRO command specifying macro number 301 . When 
the terminal receives this command, it looks up macro 301 
in its memory and displays the string it finds. If it had found 
that macro 301 was a terminal command, it would execute 
that command. 



KEY MACROS 

Each key or key combination is matched to macro numbers 
as shown in the tables with the DEFINE command descrip- 
tion in Section 5. For keys that produce ASCII characters, 
the associated macro number is the ASCII decimal equiva- 
lent of that character. For example, the ASCII decimal 
equivalent of the uppercase P is 80. If macro number 80 has 
been defined, pressing uppercase P produces that macro. 
The uppercase P key is now defined. 

In addition to being expanded by a keystroke, key macros 
can be expanded by the EXPAND MACRO command just as 
host macros are. 

When the terminal first enters Edit mode, key macros are 
disabled. To enable them while in Edit mode, use the 
ENABLE KEY EXPANSION command. 
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Key Macro LEARN 

You can easily define key macros from the keyboard by 
using the LEARN or NVLEARN Setup command. This 
method allows you to define a key by pressing the ASCII 
keys that make up the sequence instead of having to enter 
key codes. 



Disabling Key Macros 



mand KEYEXPAND) lets you choose when you want key 
macros in effect. When key macros are not in effect, all 
characters produce their normal character; their are no spe- 
cial key definitions in effect. The key macros are still saved, 
however, and can be put back into effect by either the oper- 
ator or a host program. If you disable key macros, they can 
still be expanded by the EXPAND MACRO command sent 
from the host. 



When the defined key is pressed, the characters enclosed 
by the key-execute characters are used locally. If these 
characters are a terminal command, they are executed. If 
they are not a terminal command, they are displayed as if 
the operator typed them. The characters are not sent to the 
host. 

Key-execute characters in macros expanded by an 
EXPAND MACRO command have no special meaning; they 
are treated just like other characters in the macro. Macros 
expanded by the EXPAND MACRO command are always 
treated as if they were sent by the host. 

When defining a macro to be used locally, make certain you 
include the second key-execute character. Otherwise, fol- 
lowing key macros are used locally until the terminal 
encounters another key-execute character. 



VOLATILE AND NONVOLATILE MACROS 



Keeping a Key Macro Local 

You might want a macro to only be displayed on the screen, 
or you might want a key macro to be interpreted as a com- 
mand to the terminal. In these cases, you do not want the 
macro sent to the host, but want it executed locally. To cre- 
ate such a macro, follow these steps: 

1 . Send the SET KEY EXECUTE CHARACTER command 
to the terminal. This command defines one character to 
be the key-execute character. When this character is in 
a macro it means that fo!!owin n characters should be 
used locally until the key-execute character again 
appears in the string. 

2. Send the DEFINE MACRO command to define the 
macro. Put a key-execute character at the beginning 
and the end of the string. 



The terminal can store a macro in two ways. A volatile 
macro is stored in volatile memory — the macro is not 
retained when the terminal is turned off or reset. A nonvola- 
tile macro is stored in nonvolatile memory — when the ter- 
minal is turned off or reset, the macro is retained. When ftie 
terminal is turned on or reset, all nonvolatile macros are in 
effect. 

A macro can be stored in both volatile and nonvolatile mem- 
ory at the same time. When a macro is expanded, the termi- 
nal first checks volatile memory for the macro. If the macro 
is not found in volatile memory, the terminal continues its 
search in nonvolatile memory. 

The DEFINE MACRO command defines only the volatile 
version of a macro. The DEFINE NONVOLATILE MACRO 
command defines both the volatile and nonvolatile version 
of a macro. To actually save the nonvolatile version in non- 
volatile memory, you must issue a SAVE NONVOLATILE 
PARAMETERS command before turning off or resetting the 
terminal. 
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PIXEL OPERATIONS 



NOTE 

Pixel operations require that you have 4105 Option 30 
Pixel ROMS or 4105F30 Pixel ROMS. You can see if 
your terminal has these ROMs installed by using the 
STATUS PIXELS Setup Command. 

Pixel operations give the user a much faster way to place 
images on the screen or to modify images currently there. 
You can use pixel commands to quickly display and transmit 
very complex images — much more quickly than with line or 
panel graphics commands. Unlike line graphics that make 
up images with a series of MOVEs and DRAWs, pixel opera- 
tions compose images with groups of pixels. 

IK pixel is the smallest screen element that a terminal can 
address. If you display a single pixel on the screen, you will 
see a tiny dot of color. If all the pixels in a given area are the 
same color, then the area is that color. But if the pixels in an 
area alternate between two or more different colors, the 
area appears to be a color different from any of the individ- 
ual pixels. 

Each pixel on the screen corresponds to a memory location 
in a special memory area called raster memory. As the ter- 
minal scans across the raster memory, it reads the number 
stored in each location. That number represents a color 
index'm the color map. The terminal reads color indices 
from raster memory, looks in the color map for the entry cor- 
responding to that index, and displays the pixel using the 
color mix defined by that entry. Thus, the screen display is a 
visual copy of the contents of the raster memory; and by 
changing the contents of raster memory, you can change 
the image on the screen. One method of doing this is to use 
pixel operations. 



WAYS OF USING PIXEL OPERATIONS 

All pixel writing operations use an ALU mode parameter, 
set by the BEGIN PIXEL OPERATIONS command. The ALU 
mode determines how the new color index information in a 
pixel writing command will affect the pixel information cur- 
rently stored in raster memory. Depending on the ALU 
mode, a pixel writing command may erase the screen, 
replace one image with another, or combine images 
(see the BEGIN PIXEL OPERATIONS command 
description for details). 

One useful feature of pixel operations is the off-screen 
memory. This is an area of raster memory that is not visible 
on the screen but can be written to and copied from. Off- 
screen memory is useful as a scratch pad, or as a storage 
area where you can store images for later retrieval. For 
example, you could store a special graphics character font 
in off-screen memory and retrieve each character as it was 
needed with a PIXEL COPY command. 

You should be aware that the results of pixel commands dif- 
fer significantly between different Tektronix terminals, pri- 
marily because of the different dimensions of raster 
memory. If you write a program for this terminal that uses 
pixel commands, you may need to rewrite the program so 
that it works on another Tektronix terminal. This is especially 
true if your program uses the off-screen memory. 
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WRITING INTO THE PIXEL VIEWPORT 

You can access the individual pixels of the terminal's raster 
memory using the terminal's pixel commands. These com- 
mands fall into two categories: preparation commands and 
pixel-writing commands. There are three preparation com- 
mands: BEGIN PIXEL OPERATIONS, SET PIXEL VIEW- 
PORT, and SET PIXEL BEAM POSITION; and there are four 
pixel-writing commands: RASTER WRITE, RUNLENGTH 
WRITE, PIXEL COPY, and RECTANGLE FILL. The following 
examples briefly explain each of these commands, with the 

CAVCf;uui i ui riAi-L wr i . i lie i i/\i_l-\^^^i t vuiiii iicii iu 

copies pixels from one rectangular region in raster memory 
space to another rectangular region. Refer to the command 
descriptions in for additional information about these com- 
mands. 

Figure 3-8 shows commands that define a pixel viewport 
and write some color indices into that pixel viewport. (The 
commands are shown in both Setup syntax and Host syn- 
tax.) Let's consider these commands, one by one. 



PXBEGIN. In this example, no parameter values are given. 
Therefore, the PXBEGIN (BEGIN PIXEL OPERATIONS) 
command assumes default parameters 1,11, and 6. These 
parameters specify Graphics Surface 1 as the pixel-writing 
surface, set the ALU mode to 1 1 (Replace), and specify that 
6 bits per pixel be used to store each color index. 

PXVIEWPORT 100 100 109 109. The PXVIEWPORT (SET 
PIXEL VIEWPORT) command defines a rectangular region 
on the pixel-writing surface. In this example, the lower-left 
and upper-right corners of the pixel viewport are at 

nnO 1Q(N and MQ9 1fl<M rosnoctiyel" Those onnrHinatoc 

are in 480-by-360 raster memory space. 

PXRECTANGLE 100 100 109 109 0. The PXRECTANGLE 
(RECTANGLE FILL) command sets all pixels within a rec- 
tangular region to the same color index. In this example, the 
command clears the pixel viewport by setting all pixels in 
that region to Color Index 0. 



Setup Command 


Host Syntax 


PXBEGIN 


1 -(.RU1:6 


PXVIEWPORT 100 100 109 109 


■xRS'MS J s p[ 3 f yVtf 


PXRECTANGLE 100 100 109 109 


■xRS^e | s p[-'=- ' v"'pY0 


PXPOSITION .. 4 


E cRH s pca s p(fi' 


PXRASTERWRITE 4 '4002" 


E cRP444002 


PXPOSITION 3 3 


e cRH s po " V" 


PXRASTERWRITE 4 "4217- 


E cRP444217 


0000000000 


f H 




0000000000 






0000000000 






0000000000 






0000000000 
0004002000 


PIXEL VIEWPORT 




0004217000 






0000000000 


'. .: : -i!^ • : 




0000000000 






0000000000 


^ ....... ...-i 




DISPLAY 





Figure 3-8. Writing Into the Pixel Viewport Using RASTER WRITE. 
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PXPOSITION 3 4. The PXPOSITION (SET PIXEL BEAM 
POSITION) command moves the pixel beam to the point 
(3,4). These coordinates are relative to the lower-left corner 
of the pixel viewport. 

PXRASTERWRITE 4 "4002". The PXRASTERWRITE 
(RASTER WRITE) command writes the Color Indices 4, 0, 0, 
and 2 into four successive pixels. At the end of this com- 
mand, the pixel beam position is at (7,4). These coordinates 
are relative to the lower-left corner of the pixel viewport. 

PXPOSITION 3 3. This moves the pixel beam to the position 
(3,3). These coordinates are relative to the lower-left corner 
of the pixel viewport. 

PXRASTERWRITE 4 "4217". This writes the Color Indices 
4, 2, 1 , and 7 into four successive pixels. At the end of this 
operation, the pixel beam position is at (7,3). These coordi- 
nates are relative to the lower-left corner of the pixel view- 
port. 



You can use PXRUNLENGTHWRITE (RUNLENGTH 
WRITE) commands as well as PXRASTERWRITE 
commands to write in the pixel viewport. 
PXRUNLENGTHWRITE (using an array of specially 
encoded integers called runcodes) specifies the number of 
pixels in a sequence, and sends the same color index to 
each pixel in the sequence. The next three paragraphs and 
Figure 3-9 explain how this is done. 

As in Figure 3-8, Figure 3-9 uses PXBEGIN (this time with 
bits-per-pixel set to 3) and PXVIEWPORT commands to 
define a pixel viewport that is ten pixels wide and ten pixels 
high. As before, a PXRECTANGLE command is used to set 
all pixels in the pixel viewport to Color Index 0. This time, 
however, there is no PXPOSITION command, so the pixel 
beam position starts at the upper-left corner of the pixel 
viewport. 
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In this example (Figure 3-9), the RUNLENGTH WRITE com- 
mand has four runcodes in its integer-array parameter. 
Each runcode is a single number into which two other num- 
bers are packed. The runcodes are packed using the form: 

Runcode = (number-of-pixels) * (2 W ) + (color-index) 

where/? = number-of-bits-per-pixel 



The first code, 1 60, calls for 20 pixels of Color Index (20 x 
(2 3 ) + = 160). The second code, 243, calls for 30 pixels of 
Color Index 3 (30 x (2 3 ) + 3 = 243). The third code, 160, 
calls for 20 pixels of Color Index 0; it is the same as the first 
code. The fourth code, 246, calls for 30 pixels of Color Index 
6 (30 x (2 3 ) + 6 = 246). 



The bits-per-pixel parameter from the most recent BEGIN 
PIXEL OPERATIONS command supplies the value for n 
unless that parameter is 4 or 6; then the value of n is 3. 



Setup Command 




Host Syntax 




PXBEGIN 1 11 3 




fc <RU1-3 




PXV EWPOR7 100 100 0« 109 




EcRS^e^pfVySpY 




~ *-"■!.'. TANG =. 100 l( 1 0« 109 • 




E cRR s pe; s p[ Sp "y Sp Y0 




PXRUNLENGTHWRITE 160 243 160 


246 


E cRL4J003J006 




0000000000 




( "I 




0000000000 








3333333333 








3333333333 








3333333333 
0000000000 




PIXEL VIEWPORT 




0000000000 








6666666666 








6666666666 




BBilli"'""' liitipSM^ 




666666666b 




^ _.„ 




•: SPL A> 



Figure 3-9. Writing into the Pixel Viewport Using RUNLENGTH WRITE. 
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SCREEN EDITING SUPPORT 



INTRODUCTION 

This section covers the text entry and editing functions of 
the terminal. Explanations include: 

• A discussion of how to use this terminal with screen 
editing programs 

• A description of the syntax conventions used in the 
command descriptions 

• A detailed description of each command 



SCREEN EDITING CONCEPTS 



SCREEN EDITING FEATURES 

The cursor is displayed on the screen as an underline at the 
current cursor position. When you execute text manipula- 
tion commands, they affect the characters displayed on the 
screen relative to the position of the cursor. The line of text 
on which the cursor is located is referred to in this manual 
as the current line. The position of the cursor on that line is 
referred to as the cursor position. 

You can set the display characteristics of the cursor with the 
ACURSOR Setup mode command. This command lets you 
select the cursor blink and color. Refer to the 4100-Style 
Parameter Types, Commands, and Reports section of this 
manual for more information. 



Screen editing programs allow you to view and edit a com- 
puter file. This terminal has a fully addressable cursor and 
can insert, erase, or delete characters or lines. You can use 
any existing screen editing program with this terminal as 
long as it uses commands that are compatible with the ANSI 
X3.64 command set. 

The terminal's command set is a subset of the ANSI X3.64 
and ISO 6429 standards. This command set is compatible 
with most screen editing programs that issue ANSI X3.64 
commands. 



Each character on the screen has a unique horizontal row 
and vertical column address. You can specify exact cursor 
positions using these row and column addresses. 

You can use the SGR (Select Graphic Rendition) command 
(described later in this section) to select the display style of 
the text from the following: 

• Normal — White characters on a transparent 
background 

• Bold — Characters displayed in Color Index 2 (default 
is red) 

• Underscore — Underlined characters 

• Blink — Blinking characters 

• Reverse video — Black character on a white 
background 

• Colors — Choice of eight colors for characters, charac- 
ter background, and dialog background 
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OPERATING MODES 

The terminal has four major operating modes and many 
submodes that determine how commands affect the display. 
The major modes are Ansi mode, Setup mode, Tek mode, 
and VT52 mode. All screen editing must be done in Ansi 
mode or VT52 mode. Figure 4-1 shows the relationship of 
these modes to each other. 

To use a screen editing program: 

• The terminal's dialog area must be visible. 

• The terminal must be in Ansi mode so it can accept 
ANSI commands (use the SELECT CODE command 
with the Ansi parameter), or in VT52 mode so that it can 
accept VT52 commands (use the SELECT CODE 
command with the VT52 parameter). 



You can set each Ansi submode individually, or you can use 
Edit mode. Entering Edit mode automatically sets all Ansi 
submodes so that the terminal is compatible with most 
VT100 software. When you enter Edit mode, the terminal 
automatically: 

• Enters Ansi mode 

• Sets Origin mode to Absolute 

• Sets Insert/Replace mode to Replace 

• Sets the dialog buffer to 24 lines 

• Makes the dialog area visible 

• Defines a scrolling region the size of the visible dialog 
buffer (24 lines) 

• Disables all macro expansion 

You can enable macro expansion with the KEYEXPAND 
YES Setup mode command. 




TERMINAL 



-Tek mode - 



-Setup mode- 



Ansi mode 
'Edit mode 



-VT52 mode- 



All Tek mode commands 
Alpha mode 
Vector mode 
Marker mode 
Graphic Input mode 
Interactive Color mode 



All Setup mode commands 
Interactive Color Interface 



All Ansi mode commands 
Origin mode 
Insert/Replace mode 
Linefeed/Newline mode 
Overstrike/Replace mode 
Autowrap mode 
Auto repeat mode 
Cursor Key mode 
Keypad mode 
Interactive Color mode 



All VT52 mode commands 
Graphics mode 
Keypad mode 



Figure 4-1. Terminal Modes. 
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While in Ansi or Edit mode, you can set or reset the sub- 
modes to change the operating characteristics of the 
terminal: 

• Origin mode — Determines how the cursor is addressed 
in the fixed and scrolling regions of the dialog buffer. 

• Insert/Replace mode — Determines how text is entered 
at the cursor position. In Insert mode, entered charac- 
ters are inserted preceding the cursor position, which 
moves the character at the cursor position and all char- 
acters to the right of the cursor toward the right of the 
screen. In Replace mode, entered characters replace 

nv!nllnn nknro/i4nrr 

• Linefeed/Newline mode — Determines the position of 
the cursor when a linefeed is performed. In Linefeed 
mode, when the cursor is moved down a line with a l f 
character, it remains in the same column on the new 
line. In Newline mode, the l f character moves the cursor 
to the beginning of the new line. Linefeed/Newline mode 
does not affect cursor movement commands such as 
CUD (Cursor Down) and IND (Index). 

• Overstrike/Replace mode — Determines how s p (Space) 
and _ (Underscore) are handled on the terminal screen. 

In Replace mode, s p and are displayed as visible 

characters. In Overstrike mode, s p moves the cursor one 
character to the right and _ underlines the current 
character. 

• Autowrap mode — Determines what the cursor does at 
the end of a line. When this mode is set, characters 
entered in Column 80 wrap around to the next line. 
When this mode is reset, characters entered in Column 
80 write over any existing character in Column 80. 

• Autorepeat mode — Enables the Autorepeat feature of 
the keyboard. When this mode is set, keyboard keys 
repeat when held down. When this mode is reset, key- 
board keys do not repeat when held down. 

• Cursor Key mode — Controls the effect of function keys 
F1 through F4. 

• Keypad mode — Causes the keypad to send either 
numeric or application codes when pressed. 

• Column mode — Specifies whether the dialog area will 
be 80 or 1 32 columns wide. Only 80 of the 1 32 columns 
are displayed at any time, but scrolling horizontally will 
bring any of the columns into view. 

• Screen mode — Reverses the colors on the display. 



While in VT52 mode, you can enter or exit two submodes by 
issuing one of the commands associated with those modes: 

• Graphics mode — Entering this mode selects the Rul- 
ings characters as the GO character set; exiting this 
mode restores the character set that was in effect (as 
GO) prior to entering this mode. 

• Alternate Keypad mode — Entering this mode gives the 
numeric keypad and function keys F5 — F8 meanings 
different than the factory default or programmed mean- 
ings; exiting this mode restores the factory default or 
programmed meanings. 

If you switch back and forth between Ansi and VT52 modes, 
the numeric keypad retains its mode selection, although the 
mode name changes. Therefore, if the keypad sends 
numeric codes while in Ansi mode, then it sends factory 
default meanings when it enters VT52 mode. If the keypad 
sends applications codes while in Ansi mode, then it sends 
the alternate keypad meanings in VT52 mode (see the VT52 
command description ENTER ALTERNATE KEYPAD 
MODE). 
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THE DIALOG AREA 

All text editing and entry occur in the dialog area. The dialog 
area is a display area of the terminal that is separate from 
the graphics area. The ANSI commands work only in the 
dialog area. Before executing any program that uses the 
dialog area, make it visible with the SET DIALOG AREA 
VISIBILITY command or by pressing the Dialog key. 

Since the syntax of the Ansi, Tek, and VT52 mode com- 
mands are not compatible, you must send the SELECT 
CODE command to the terminal with a parameter of 1 (to 
select Ansi mode) or 2 (to select Edit mode). Alternatively, 
the operator can type CODE EDIT or CODE ANSI in Setup 
mode. Once you have done this, you can use ANSI com- 
mands to manipulate the text in the dialog area. 

The dialog buffer can have as many lines as there is mem- 
ory available to hold them, with up to 30 lines visible on the 
screen at any one time. You can set the number of lines in 
the dialog buffer with the SET DIALOG AREA BUFFER 
SIZE command. You can set the number of lines that are 
visible with the SET DIALOG AREA LINES command. If the 
dialog buffer has more than 30 lines, the excess lines are 
not visible on the screen, but can be scrolled into view. 

The ANSI command set allows the terminal to have up to 
two fixed regions and one scrolling region on the screen at 
the same time. This can be useful when, for example, your 
screen editor program has a status or message line at the 
top or bottom of the text editing region; the editing region is 
the scrolling region and the status lines are the fixed 
regions. 

You can set the edit margins of the scrolling region with the 
SET TOP AND BOTTOM MARGINS command. If the edit 
margins coincide with the terminal screen size, then there 
are no fixed regions and the scrolling region contains the 
entire dialog buffer. Otherwise, the lines between and 
including the edit margins are in the scrolling region, and 
the lines outside the scrolling region are in the fixed regions. 



The cursor can be moved from the scrolling region into a 
fixed region only by entering a CUP (Cursor Position) or 
HVP (Horizontal and Vertical Position) command while in 
Origin mode Absolute. Figure 4-2 shows how the dialog 
buffer and edit margins relate to the terminal display. 

If the cursor is visible, the dialog buffer is rolled up or down 
as cursor movement commands are performed, so the cur- 
sor always remains in view. The exceptions to this are the 
SU (Scroll Up) and SD (Scroll Down) commands (and the 
equivalent joydisk movements). In scrolling, the dialog 
buffer is rolled up or down and the cursor maintains its posi- 
tion with respect to the dialog buffer, therefore, the cursor 
may move out of view. 

If the cursor is not visible, cursor movement commands will 
not cause the dialog buffer to be rolled up or down. 

Origin mode determines how the cursor is addressed in 
these fixed and scrolling regions. In Origin mode Absolute, 
you can address any character position relative to the 
upper-left character position of the dialog buffer (character 
address Row 1 , Column 1). The scrolling region and the dia- 
log buffer size are limited to the size of the terminal screen 
(30 lines maximum). In Origin mode Relative, you can 
address any character position in the scrolling region rela- 
tive to the upper-left character position of the scrolling 
region. If edit margins have not been set, then the scrolling 
region is the same size as the dialog buffer (up to 49 lines). 
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VISIBLE 
PORTION 
OF THE 
DIALOG 
BUFFER 



EDIT 
MARGINS 



DIALOG BUFFER 
(SCROLLING REGION) 



15 
16 
17 



20 
21 



22 
23 



(When edit margins are not set, 

the dialog buffer is the scrolling region.) 



SCREEN 



15 
16 
17 



20 
21 



When Origin mode is Relative, the cursor 
moves with respect to the scrolling region. 
When Origin mode is Absolute, the cursor 
moves with respect to the dialog buffer. 



DIALOG BUFFER 




FIXED REGION 



SCROLLING 
REGION 



FIXED REGION 




(When edit margins are set, the dialog buffer 
is the same size as the screen.) 



Figure 4-2. Fixed and Scrolling Regions in the Dialog Area. 
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ANSI MODE COMMANDS 



EDITING ON THIS TERMINAL 



The Ansi mode commands allow you to: 

• Position the cursor 

• Configure the different regions by setting the edit 
margins 

• Delete characters and lines 

• Erase characters and lines 

• Insert characters and lines 

• Set the attributes of displayed characters 

• Control functions and modes 

Cursor movement commands, such as CUU (Cursor Up) 
and CUP (Cursor Position), allow you to move the cursor rel- 
ative to its current position or directly to a specified screen 
location. 

Deletion commands, such as DCH (Delete Character) and 
DL (Delete Line), allow you to delete characters or lines in 
the dialog buffer. 

Erasure commands, such as ED (Erase in Display), allow 
you to erase or blank characters or lines in the dialog buffer. 

Insertion commands, such as IC (Insert Character) and IL 
(Insert Line), allow you to insert characters or lines in the 
dialog buffer. 

Other commands allow you to save and restore the cursor 
position, change the appearance of displayed text, set and 
reset modes (such as Insert/Replace or Overstrike/Replace 
mode), or receive status reports from the terminal. 

VT52 MODE COMMANDS 

The VT52 mode commands allow you to: 

• Position the cursor 

• Erase portions of text 

• Control functions and modes 

Cursor movement commands move the cursor up, down, 
left, and right with respect to the dialog buffer. 

Erasure commands erase portions of lines or portions of the 
screen from the current position to the end of the line or bot- 
tom of the screen. 



Using an Existing Editor That Understands 
ANSI X3.64 or VT52 Commands 

You can use any existing screen editing program with this 
terminal as long as it sends commands to the terminal that 
are compatible with the ANSI X3.64 command set or the 
VT52 command set. You may not be able to use all of your 
editor's features with this terminal, and your editor may not 
be able to use all of this terminal's features. The detailed 
command descriptions provided later in this section explain 
how the terminal responds to each particular ANSI or VT52 
command. 

If your editing program is compatible with VT1 00 terminals, 
enter the SELECT CODE command with Edit as a parame- 
ter, which configures the terminal to run most VT1 00 appli- 
cations programs. 

If your editing program is compatible with VT52 terminals, 
enter the SELECT CODE command with VT52 as a parame- 
ter, which configures the terminal to run most VT52 applica- 
tions programs. The terminal should be in Edit mode prior to 
selecting VT52 mode so that the terminal characteristics set 
by Edit mode will remain in effect. 

The documentation supplied with your particular editor 
should define any deviation from ANSI X3.64. 



Designing an Editor to Work With This Terminal 

If you are designing a new text editor for this terminal, you 
should carefully study the detailed command descriptions 
provided later in this section. The editing program must be 
designed to send the appropriate terminal command to per- 
form the desired screen function. 



Terminal Initialization File 

Most screen editing programs use some type of terminal ini- 
tialization file that allows them to work with more than one 
type of terminal. This file is basically a command translation 
table that tells the editing program what particular com- 
mands the terminal requires to perform the editing func- 
tions. Refer to the documentation supplied with your editor 
for more information. 



Some commands, such as IDENTIFY, control functions; oth- 
ers, such as ENTER GRAPHICS MODE, control modes. 
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ANSI AND VT52 COMMAND AND REPORT 
DESCRIPTIONS 

Command Conventions 

The following points summarize the syntax used in the com- 
mand descriptions in this section: 

• The command name is shown in all uppercase 
characters. 

• Characters shown in bold type are those that you must 
enter exactly as shown. 

• I n Host syntax, enter parameters on the same line and 
separate them with semicolons. If you are entering more 
than one parameter, any parameters that begin with ?, 
<, = , or >should be at the beginning of the list of 
parameters. 

• In Setup syntax, enter parameters on the same line and 
separate them with a space or a comma. 

• Most commands take integer values for their parame- 
ters. Integers do not need to be packed. The valid range 
is — 32767. If you specify a value higher than is reason- 
able for a particular parameter, the parameter defaults to 
the highest value that it can accept. For example, if you 
specify column 200, the parameter defaults to 1 32. 

• Two commands, RM (Reset mode) and SM (Set mode), 
take string parameters. The valid character strings are 
shown with each command. 

• Multiword items are joined by hyphens. For example, 
descriptive-parameter-name and optional-parameter are 
single items described by two or more words. 

• Default parameter values, if any, are shown at the end of 
each parameter description. Appendix D contains a 
table that lists all of the parameters and their default 
values. 

Figure 4-3 illustrates the command description format. 



COMMAND NAME 

The purpose of the command. 
Host Syntax 



E c[parameter-name; next-parameter-name Z 



parameter-name: Each parameter is explained in a separate 

naranranh anri inrti iHfaQ itQ rannp nf yah iaq sanrl Hpfai ilts 

Defaults: Omitted = The value assigned a parameter if the 
command is used and no value is 
specified for the parameter. 



next-parameter-name: The next parameter explained. 
Defaults: Omitted = Value 



Figure 4-3. Command Description Format for ANSI and VT52 
Commands. 
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ANSI COMMANDS 

b l (Bell Character) 

Sounds the terminal's bell. 

B s (Backspace Character) 

Moves the cursor left one position. 

The B s character moves the cursor one character position to 
the left. If the cursor is already at Column 1 , then B s has no 
effect. 



CBT (Cursor Backward Tab) 

Moves the cursor backwards to a preceding tab stop on the 
current line. 

Host Syntax 



E c[ number-of-preceding-tab-stops Z 



number-of-preceding-tab-stops: Enter 1 to move the cursor 
to the preceding tab stop. A value greater than 1 («) moves 
the cursor to the nth preceding tab stop on the current line. 
If there are less than n preceding tab stops, the cursor 
moves to Column 1 of the current line. 
Default: Omitted or = 1 



CHT (Cursor Horizontal Tab) 

Moves the cursor forward to a following tab stop on the 
current line. 



Host Syntax 



E c[ number-of-following-tab-stops I 



number-of-following-tab-stops: Enter 1 to move the cursor 
to the next tab stop. A value greater than 1 (n) moves the 
cursor to the nth next tab stop on the current line. If there 
are less than n following tab stops, the cursor moves to the 
end of the current line. 
Default: Omitted or = 1 



c n (Cancel Character) 

Cancels an Ansi mode command in progress. 

CPR (Cursor Position Report) 

Provides the row and column address of the current cursor 
position. 

Host Syntax 



E c[ row ; column R 



The CPR (Cursor Position Report) message is sent from the 
terminal to the host in response to a DSR (Device Status 
Report) command with 6 for a parameter. 

If Origin mode is Relative (TEKOM set), the coordinates 
reported are row, column coordinates in the scrolling 
region. Row 1 , Column 1 is the upper-left corner of the 
scrolling region. 

If Origin mode is Absolute (TEKOM reset), the coordinates 
reported are row, column coordinates of the dialog buffer. 
Row 1 , Column 1 is the upper-left corner of the dialog buffer. 

The terminal does not enter Bypass mode for the CPR. 



c r (Carriage Return Character) 

Moves the cursor to the first column in the current line. 

If Carriage Return/Linefeed ( c r l f) mode is set, a linefeed 
action is also performed. 
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CUB (Cursor Backward) 

Moves the cursor left the specified number of coiumns. 
Host Syntax 



E c[ number-of-columns D 



number-of-columns: The number of columns to move the 
cursor toward the left side of the screen. The cursor does 
not move bevond Column 1 . 



If Column mode is set to 1 32, the cursor may disappear 
from the screen. This command will not scroll horizontally to 
keep the cursor in view. 



CUD (Cursor Down) 

Moves the cursor down the specified number of lines. 
Host Syntax 



E c[ number-of-lines B 



number of lines: The number of lines to move the cursor 

down. 

Default: Omitted or = 1 

If Origin mode is Absolute (TEKOM reset), the cursor moves 
with respect to the dialog buffer. 

If Origin mode is Relative (TEKOM set), the cursor moves 
with respect to the scrolling region. 



CUF (Cursor Forward) 

Moves the cursor the specified number of coiumns to the 
right. 

Host Syntax 



E c[ number-of-columns C 



number-of-columns: The number of columns to move the 
cursor toward the right side of the screen. The cursor does 

n/-it mm/o hovr^nH tho rinhtmnct marnin 

I ivy l tllWIV WVTWIIW HIV ■ iVji ■.■ nv^i inhi gm. 

Default: Omitted or = 1 

If Column mode is set to 132, the cursor may disappear 
from the screen. This command will not scroll horizontally to 
keep the cursor in view. 



CUP (Cursor Position) 

Moves the cursor to a specified row and column. 
Host Syntax 



E c[ row-number; column-number H 



row-number: The destination row for the cursor. 
Default: Omitted or = 1 

column-number: The destination column for the cursor. 
Default: Omitted or = 1 

If Origin mode is Relative (TEKOM set), the cursor moves 
with respect to the scrolling region. Row 1 , Column 1 is the 
upper-left corner of the scrolling region. 

If Origin mode is Absolute (TEKOM reset), the cursor moves 
with respect to the dialog buffer. Row 1, Column 1 is the 
upper-left corner of the dialog buffer. 
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CUU (Cursor Up) 

Moves the cursor upward the specified number of lines. 
Host Syntax 



E c[ number-of-lines A 



number-of-lines: The number of lines to move the cursor 
toward the top of the screen. 
Default: Omitted or = 1 

If Origin mode is Absolute (TEKOM reset), the cursor moves 
with respect to the dialog buffer. 

If Origin mode is Relative (TEKOM set), the cursor moves 
with respect to the scrolling region. 



DA (Device Attributes) 

Tells the terminal to report what type of terminal it is. 
Host Syntax 



E c[ device-status-request c 



device-status-request: This parameter is always 0. 
Default: Omitted = 

The host sends this command with a parameter of to the 
terminal asking it to identify what type of terminal it is. The 
terminal sends back to the host the report E c[?1 ;2c, which 
says that the terminal is similar to a VT1 00 with Advanced 
Video Option. This means that the terminal includes: 

• 132 Column mode 

• Bold, blink, underline, and reverse image character 
attributes 

If the host echos this report back to the terminal, the 
terminal ignores the echo. 



DCH (Delete Character) 

Deletes the character at the cursor and characters following 
the cursor depending on the value of the parameter. 

Host Syntax 



E c[ number-of-characters P 



number-of-characters: The number of characters to delete. 
Default: Omitted or = 1 

Any characters to the right of the deleted characters are 
moved left by the same number of character positions; thus 
the gap is filled and the remainder of the line to the right of 
the last character is filled with spaces. 

Only characters on the current line are affected by this 
command. 



DL (Delete Line) 

Deletes the specified number of lines starting with the cur- 
rent line. 



Host Syntax 



E c[ number-of-lines M 



number-of-lines: The number of lines to delete. 
Default: Omitted or = 1 

All lines following the deleted lines (including those in the 
invisible portion of the scroll) are shifted in a block toward 
the line containing the cursor. The cursor does not change 
position. If fixed and scrolling regions have been defined, 
this command only affects lines in the region that the cursor 
is currently in. For example, if the cursor is in the top fixed 
region, only the lines in the top fixed region are affected. 



4-10 



REV, SEP 1983 



4105 PROGRAMMERS 



SCREEN EDITING SUPPORT 
ANSI — ED (Erase in Display) 



DMI (Disable Manual Input) 

Disables the keyboard. 
Host Syntax 




This command is the equivalent of the Ansi mode SM com- 
mand with the KAM parameter or of the 4100-style com- 

_~.«~i i r\r*is i/cvDriADrt ,.,:*u „ _«-«_»«*».- **t h 
■ iicu iu i-Vj'wrv r\i_ i uwnnL* vvni i a \ja\ a\ ncici ui i . 



DSR (Device Status Report) 

Generates a CPR (Cursor Position Report) or a DSR 
(Device Status Report). 



Host Syntax 



E c[ status n 



status: Determines whether the DSR is a command from the 
host or a report from the terminal (see Table 4-1 for parame- 
ter values). 

When the host sends a DSR command with a parameter of 
5, the terminal responds with a DSR message telling 
whether or not there is a malfunction. When the host sends 
a DSR command with a parameter of 6, the terminal 
responds with a CPR (see CPR command for the meaning 
of the response). If the terminal receives a DSR with a 
parameter value of or 3 (which could be the echo of a 
report it has sent to the host), the terminal ignores that DSR. 



Table 4-1 
DEVICE STATUS REPORT PARAMETERS 



Parameter 


Meaning 





Report from terminal: ready — no malfunctions 
detected 


3 


Report from terminal: malfunction — try again 


5 


Command from host: report status using a DSR 


6 


Command from host: report cursor position using a 
CPR (see CPR command) 



ECH (Erase Character) 

Erases the specified number of characters starting at the 
cursor position. 

Host Syntax 



E c[ number-of-characters X 



number-of-characters: The number of characters to erase. 

i^eiauu. wmiueu Oi u = i 

Characters are erased, not deleted. When a character is 
erased, its character cell is cleared (replaced with the cur- 
rent erase color index). The cursor location remains 
unchanged. 

The effect of the ECH command is not confined to the cur- 
rent line. For example, if the cursor is in Column 41 , and an 
ECH command with a parameter of 45 is issued, the 45 
characters at and following the cursor position are erased. 
This is true even if this means erasing characters on follow- 
ing lines and into the fixed region from within the scrolling 
region. 



ED (Erase in Display) 

Erases part or all of the current display, according to the 
parameter. 



Host Syntax 



E c[ erase-extent J 



erase-extent: Enter to erase text from the cursor position to 
the end of the dialog buffer. Enter 1 to erase text from the 
beginning of the dialog buffer to the cursor position. Enter 2 
to erase the entire dialog buffer. 
Default: Omitted = 

The cursor does not change position. 
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EL (Erase in Line) 

Erases part or all of the current line, according to the 
parameter. 

Host Syntax 



E c[ erase-extent K 



erase-extent: Enter to erase text from the cursor position to 

the end of the line. Enter 1 to erase text from the beginning 

of the line to the cursor position. Enter 2 to erase the entire 

line. 

Default: Omitted = 



EMI (Enable Manual Input) 

Enables the keyboard. 



Host Syntax 



E cb 



This command is the equivalent of the ANSI-style RM com- 
mand with the KAM parameter or of the 4100-style LOCK 
KEYBOARD command with a parameter of 0. 



f f (Formfeed Character) 

The terminal inserts f f into the dialog area and advances 
the cursor position. This character indicates the start of a 
new page to a hardcopy unit (see command description for 
Tek mode command SET DIALOG HARDCOPY 
ATTRIBUTES). 



h t (Horizontal Tab Character) 

Advances the cursor forward to the next horizontal tab stop 
on the current line. 

If there are no horizontal tab stops to the right of the cursor 
position, the cursor moves to the last column of the line. 

The tab stops that are in effect when the terminal is turned 
on are at columns: 1,9,17, 25, 33, 41 , 49, 57, 65, 73, 81 , 89, 
97, 105, 113, 121, 129. These power-up tab stops can be 
changed and saved with the SAVE NONVOLATILE 
PARAMETERS command. 



HTS (Horizontal Tab Set) 

Sets a tab stop at the current cursor location or sets the tab 
stops for the entire screen. 

Host Syntax 



E cH 



Setup Syntax 



TABS list-of-tab-stops 



list-of-tab-stops: A list of numbers representing the column 
numbers where you want tab stops set. 
Default: Factory default = 1,9,17, 25, 33, 41 , 49, 57, 65, 
73,81,89,97,105,113,121,129. 

The tab stops that are in effect when the terminal is turned 
on are those stops that have been saved in nonvolatile 
memory. 



HVP (Horizontal and Vertical Position) 

Moves the cursor to a specified row and column of the 
screen. 



Host Syntax 



E c[ row-number ; column-number f 



row-number: The destination horizontal row number for the 

cursor. 

Default: Omitted or = 1 

column-number: The destination vertical column number 

for the cursor. 

Default: Omitted or = 1 

If Origin mode is Relative (TEKOM set), the cursor moves 
with respect to the scrolling region. The cursor does not 
move beyond the top and bottom of the scrolling region. 

If Origin mode is Absolute (TEKOM reset), the cursor moves 
with respect to the dialog buffer. "Row 1 , Column 1 " is the 
upper-left corner of the dialog buffer. The cursor does not 
move beyond the top and bottom of the dialog buffer. 
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ICH (Insert Character) 

Inserts the specified number of Space characters at the 
cursor position. 

Host Syntax 



E c[ number-of-characters < 



IND (Index) 

Moves the cursor down one line without affecting its charac- 
ter position on the line. 

Host Syntax 



E cD 



number-of-characters: The number of Space characters to 

insert. 

Default: Omitted or = 1 

The character currently at the cursor position and all other 
characters to the right of the cursor are shifted n columns to 
the right. Characters shifted off the end of the line are lost. 
The cursor position remains unchanged. 



IL (Insert Line) 

Inserts the specified number of blank lines in place of the 
current line. 

Host Syntax 



E c[ number-of-lines L 



number-of-lines: The number of lines to insert. 
Default: Omitted or = 1 

The current line and all following lines are shifted down. 
Lines scrolled below the bottom margin are lost. The cursor 
position does not change. 

If fixed and scrolling regions have been defined, this com- 
mand only affects lines in the region that the cursor is cur- 
rently in (if the cursor is in the scrolling (nonf ixed) region, 
only the lines in the scrolling region are affected). 



If the cursor is on the last line of the scrolling region, a blank 
line is added to the end of the scrolling region and a line is 

iciiiuvcu null I ll ic LrGUjiiliiii^ ui li ic 5l*iuiin i^ tu^iui I. I 1 10 uur 

sor can index into the scrolling region from the top fixed 
region, but cannot index into the bottom fixed region. An 
index on the last line of the bottom fixed region has no 
effect. 



l f (Linefeed Character) 

Moves the cursor position down one line. 

If LNM (Linefeed/Newline mode) is reset, then l f has exactly 
the same effect as the IND (Index) command; it advances 
the cursor to the same position on the following line of text. 
If the cursor is on the last line of the scrolling region, a blank 
line is added to the end of the scrolling region and a line is 
removed from the beginning of the scrolling region. 

If LNM (Linefeed/Newline mode) is set, then l f has the same 
effect as c r IND: it advances the cursor position to the first 
character position on the following line. 



NEL (Next Line) 

Moves the cursor to the start of the next line. 
Host Syntax 



E cE 



The NEL (Next Line) command has the same effect as 
c rIND (a Carriage Return character followed by an IND 
(Index) command); the cursor moves to the first character 
position on the next line. 
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REPORT SYNTAX MODE 

Sends a Terminal Settings Report to the host. 
Host Syntax 



E c#!0 



The Terminal Settings Report contains the terminal's syntax 
mode status. 

This command has the same effect as a REPORT TERMI- 
NAL SETTINGS command issued for the SELECT CODE 
command (as if E clQ%! was sent from the host). See the 
REPORT TERMINAL SETTINGS command in Section 5 for 
additional information. 

This command is recognized in all modes: Ansi, Edit, Tek, 
and VT52. 



Rl (Reverse Index) 

Moves the cursor position up one line without affecting the 
cursor position on the line. 

Host Syntax 



E cM 



If the cursor is on the first line of the scrolling region, a new 
line is added to the beginning of the scrolling region and a 
line is removed from the end of the scrolling region. 



RIS (Reset to Initial State) 

Resets certain terminal attributes to power-up condition. 
Host Syntax 



c cc 



When the terminal receives this command, it: 

• Erases the screen 

• Positions the dialog area cursor at the Home position 

• Sets Insert/Replace mode to Replace 

• Clears edit margins 

• Turns off the character graphic rendition feature 

• Selects default GO or G1 character set 

• Shifts in the GO character set 

• Enables the dialog area 

• Makes the dialog area visible 

RM (Reset Mode) 

Resets one or more modes. 

Host Syntax 



E c[ mode I 



mode: The terminal mode that you want to reset. 
Default: Omitted = (Causes an error) 

Each mode is specified by a separate parameter. You can 
reset more than one mode by entering more than one 
parameter separated by semicolons. If you are resetting 
more than one mode, any parameters that begin with ?, <, 
or > should be at the start of the list of parameters. Refer to 
Table 4-2 for an explanation of these parameters and what 
they mean when reset (using the RM command) and set 
(using the SM command). A mode is reset until you set it 
again with an SM (Set Mode) command. 
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Table 4-2 
RESET MODE AND SET MODE COMMAND PARAMETERS 



Parameter 


Mode Name 


Effect When Reset (RM Command) 


Effect When Set (SM Command) 


2 


KAM (Keyboard Action 

mode) 


Enables keyboard. 


Disables keyboard. 


4 


IRM (Insert/Replace 
mode) 


Causes each entered character to overwrite or 
overstrike the character at the current position. 
Can aiso be reset with the iNSERTREPLACE 
REPLACE Setup command. 


Inserts each entered character at the current cur- 
sor position and characters at and to the right of 
the cursor position are shifted to the right. Can aiso 
be set with the INSERTREPLACE INSERT Setup 
command. 


12 


SRM (Send/Receive 

mode) 


Enables the terminal's local echo (equivalent to 
ECHO YES command in Setup mode). 


Disables the terminal's local echo (equivalent to 
ECHO NO command in Setup mode). 


20 


LNM (Linefeed/ 
Newline mode) 


Determines the effect of the l f character. l f 
moves the cursor down one line, without chang- 
ing the column position. Can also be reset with 
the LFCR NO Setup command. 


Causes l f to move the cursor to the beginning of 
the next line. Can also be set with the LFCR YES 
Setup command. 


<1 


TEKORM (Overstrike/ 
Replace mode) 


Inserts the s p (space character) and (underscore 
character) as normal characters. Can also be set 
with the DAMODE REPLACE Setup command. 


Causes each entered s p to advance the cursor to 
the next character position. Causes each entered 
to underline the current character. Can also be 
reset with the DAMODE OVERSTRIKE Setup com- 
mand. 


?1 


TEKCKM (Cursor Key 
mode) 


Causes function keys F1 through F4 to transmit 
ANSI cursor control commands. If these keys are 
programmed and key expansions are enabled, 
they transmit their programmed values. Table 4-3 
shows the codes that the keys transmit in this 
mode. Can also be reset with the CURSORKEY- 
MODE NO Setup command. 


Causes function keys F1 through F4 to transmit 
application program codes. Table 4-3 shows the 
codes that the keys transmit in this mode. Can also 
be set with the CURSORKEYMODE YES Setup 
command. 


?2 


TEKANM(Ansi/VT52 

,,,vv "'; 


Puts the terminal in VT52 mode. 


Not a valid command. 


?3 


TEKCOLM 

(Column mode) 


Specifies 80-column width. Resetting Column 
mode erases the contents of the dialog area and 
resets margins. This command does not affect 
Origin mode, tabs, character attributes, or any 
other screen attributes. Also can be reset with 
COLUMNMODE 80 Setup command. 


Specifies 132-column width. The terminal displays 
only 80 of the 1 32 columns at any time, but hori- 
zontal scrolling can bring any of the columns into 
view. Setting Column mode erases the contents of 
the dialog area and resets margins, but does not 
affect Origin mode, tabs, character attributes, or 
any other screen attributes. When Column mode is 
set to 1 32, and you make the dialog area visible 
with the DIALOG key, an automatic horizontal 
scroll may occur; if the cursor is in columns 1 — 80, 
the dialog area will scroll right to bring the leftmost 
column into view; if the cursor is in columns 81 — 
132, the dialog area will scroll left to bring the right- 
most column into view. Can also be set with 
COLUMNMODE 132 Setup command. 



(continued) 
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Table 4-2 (cont) 
RESET MODE AND SET MODE COMMAND PARAMETERS 



Parameter 


Mode Name 


Effect When Reset (RM Command) 


Effect When Set (SM Command) 


?5 


TEKSCNM 
(Screen mode) 


Reverses the colors on the display from Reverse 
to Normal. If Screen mode is already Normal, 
resetting has no effect. Can also be reset with 
SCREENMODE NORMAL Setup command. 


Reverses the colors on the display from Normal to 
Reverse. If Screen mode is already Reverse, set- 
ting Screen mode has no effect. Can also be set 
with SCREENMODE REVERSE Setup command. 


?6 


TEKOM 
(Origin mode) 


Places the terminal in Origin mode Absolute. 
Moves the cursor to Row 1 , Column 1 of the dia- 
log area, and reduces the dialog buffer size to 
the screen size. Can also be reset with the ORI- 
GINMODE ABSOLUTE Setup command. 


Places the terminal in Origin mode Relative. 
Moves the cursor to Row 1, Column 1 of the scroll- 
ing region. Can also be set with the ORIGINMODE 
RELATIVE Setup command. 


?7 


TEKAWM 
(Autowrap mode) 


Disables the Autowrap function of the terminal . 
The cursor does not wrap around to the next line 
when characters are entered in the last column. 
Can also be reset with the AUTOWRAP NO 
Setup mode command. 


Enables the Autowrap feature of the terminal. Can 
also be set with the AUTOWRAP YES Setup com- 
mand. 


?8 


TEKARM (Autorepeat 
mode) 


Disables the Autorepeat function of the terminal. 
Can also be reset with the AUTOREPEAT NO 
Setup command. 


Enables the Autorepeat feature of the terminal. 
Can also be set with the AUTOREPEAT YES Setup 

command. 



Table 4-3 
CURSOR KEY MODE CODES 



Function Key 


Codes Sent 
When Set 


Codes Sent 
When Reset 


F1 


E cOA 


E C[A 


F2 


E cOB 


E c[B 


F3 


E cOD 


E c[D 


F4 


E cOC 


E c[C 
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SCS (Select Character Set) 

Selects default and special character sets. 
Host Syntax 



E c character-set 



Setup Syntax 



SELECTCHARSET GO character-set 



or 



SELECTCHARSET G1 character-set 



character-set: The parameter from Table 4-4 that designates 
the desired character set as either the GO or G1 character 
set. Do not include parenthesis in Setup syntax. 

The terminal allows you to access two different character 
sets by using the s i (selects the current GO character set) 
and s o (selects the current G1 character set) commands. 
First you must designate which of the eight possible charac- 
ter sets you want to use and then you can easily switch 
between them. 

When the terminal is turned on, the character set associ- 
ated with the particular keyboard is designated as the GO 
character set and also as the G1 character set. This com- 
mand allows you to designate different GO or G1 sets. 

Table 4-4 shows the parameters needed to select a particu- 
lar character set. Appendix B contains tables that list the 
contents of each character set. 



SCREEN EDITING SUPPORT 
ANSI — SD (Scroll Down) 



Table 4-4 
SELECT CHARACTER SET COMMAND PARAMETERS 



Parameter to 
Designate a GO 
Character Set 


Parameter to 
Designate a G1 
Character Set 


Character Set 
Designated 


(A 


)A 


United Kingdom 


(B 


)B 


U.S. (ASCII) 


(G 


)G 


Swedish 


i\s 


)K 


German 


(f 


)f 


French (See note) 


(■ 


)' 


Danish/Norwegian 


(0 


)0 


Ruling Set 


(3 


)3 


Supplementary 



NOTE 

Please use (f or )f to designate the French character 
set. These are the current standard escape sequence 
parameters. However, for compatability with pro- 
grams designed for an earlier version of the French 
character set, the terminal does accept (R and )R as 
synonyms for (f and )f, respectively. 



SD (Scroll Down) 

Scrolls lines down. 
Host Syntax 



E c[ number-of-lines T 



number-of-lines: The number of lines to scroll toward the 
bottom of the screen. 
Default: Omitted or = 1 

The SD command shifts all lines in the dialog buffer down 
the specified number (n) of rows. The n lines at the bottom 
margin are rolled out of sight and n lines are rolled into view 
at the top margin. 
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SELECT CODE 

Causes the terminal to recognize Ansi, Tek, or VT52 mode 
command syntax. Also used to select Edit mode. 

Host Syntax 



E c%! syntax 



Setup Syntax 



CODE syntax 



syntax: selects Tek mode syntax. 1 selects Ansi mode syn- 
tax for Ansi mode. 2 selects Ansi mode syntax for Edit 
mode. 3 selects VT52 mode syntax. In Setup mode, enter 
TEK, ANSI, EDIT, or VT52. Default: Omitted = (Tek 
mode) 

The syntax of Tek, Ansi, and VT52 mode commands are not 
compatible. If you are using commands from one mode and 
want to execute one or more commands from another 
mode, you must issue the Select Code command with the 
appropriate parameter. 

This command is recognized in all major modes: Ansi, 
Setup, Tek, and VT52. 

Edit mode allows the terminal to be used with VT-100 appli- 
cation programs. Selecting this mode sets the following ter- 
minal characteristics: 

• Selects ANSI X3.64 syntax 

• Sets Origin mode to Absolute 

• Sets the dialog buffer to 24 lines 

• Sets Insert/Replace mode to Replace 

• Enables the dialog area and makes it visible 

• Defines a scrolling region the size of the dialog buffer 
(24 lines) 

• Disables all programmed keys (the programmed mean- 
ings remain available; use the Setup command KEYEX- 
PAND yes to enable them) 



SGR (Select Graphic Rendition) 

Invokes the character display style specified by the 
parameters. 

Host Syntax 



E c[ graphic-rendition m 



Setup Syntax 



TEXTRENDITION graphic-rendition 



graphic-rendition: The style in which text is displayed in the 
dialog area. 
Default: Omitted = 

In Host syntax, you can set more than one display attribute 
by entering more than one parameter separated by semico- 
lons. In Setup mode, parameters must be separated by one 
or more spaces. If you are entering more than one parame- 
ter, any parameters that begin with ?, <, = , or > should be 
at the start of the list of parameters. Refer to Table 4-5 for an 
explanation of these parameters. All characters after you 
send the SGR command are displayed as specified by the 
SGR parameters until you execute another SGR command. 

In Table 4-5, foreground index is the color index of the char- 
acters as they are displayed on the screen. Background 
index is the color of the screen on which the characters are 
displayed. Erase index is the color with which the characters 
are erased when a delete or erase command is issued. 
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Table 4-5 
SGR COMMAND PARAMETERS 



Table 4-5 (cont) 
SGR COMMAND PARAMETERS 



Parameter 


Description 





Characters displayed in specified color indices 
with all other attributes (blink, bold, under- 
score, reverse) turned off. 


1 


Bold or increased intensity. Bold text is dis- 
played in Color Index 2. Color Index 2 defaults 
to red. Character background remains the 
same as current background index. 


4 


Underscore text. 


5 


Slow blink (less than 150 blinks per minute). 


7 
24 


Reverse video text. Foreground and back- 
ground color indices are swapped. 
No underscore. Cancels the effect of SGR with 
graphic-rendition set to 4. 


25 


No blink. Cancels the effect of SGR with 
graphic-rendition set to 5. 


27 


Positive video text. Cancels the effect of SGR 
with graphic-rendition set to 7. 


30 


Black display. Sets current character color 
index to 0, which defaults to black. 


31 


Red display. Sets current character color index 
to 2, which defaults to red. 


32 


Green display. Sets current character color 
index to 3, which defaults to green. 


33 


Yellow display. Sets current character color 
index to 7, which defaults to yellow. 


34 


Blue display. Sets current character color index 
to 4, which defaults to blue. 


35 


Magenta display. Sets current character color 
index to 6, which defaults to magenta. 


36 


Cyan display. Sets current character color 
index to 5, which defaults to cyan. 


37 


White display. Sets current character color 
index to 1 , which defaults to white. 


39 


Default display color, Color Index 1 , which 
defaults to white. 


40 


Transparent background. Sets current charac- 
ter background color index to 0, which defaults 
to transparent. 



Parameter 


Description 


41 


Red background. Sets current character back- 
ground color index to 2, which defaults to red. 


42 


Green Background. Sets current character 
background color index to 3, which defaults to 
green. 


43 


Yeliow background. Sets current character 
background color index to 7, which defaults to 
yellow. 


44 


Blue background. Sets current character back- 
ground color index to 4, which defaults to blue. 


45 


Magenta background. Sets current character 
background color index to 6, which defaults to 
magenta. 


46 


Cyan background. Sets current character back- 
ground color index to 5, which defaults to cyan. 


47 


White background. Sets current character 
background color index to 1 , which defaults to 
white. 


49 


Default background color, Color Index 0, which 
defaults to transparent. 


< index 


Character color. Parameter specifies the color 
index. Indices from to 7 select colors in the 
terminal's color map. Indices greater than 7 
default to 7. 


= index 


Background color. Parameter specifies the 
character background color index. Index 
means that the graphics area shows through. 
Background indices from 1 to 7 represent col- 
ors in the terminal's color map. Indices greater 
than 7 default to 7. 


> index 


Erase color. Parameter specifies the dialog 
area erase color index. Erase Index always 
means that the graphics area shows through. 
Indices from 1 to 7 select colors in the termi- 
nal's color map. Indices greater than 7 default 
to 7. 
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s i (Shift In Character) 

Invokes the current GO character set. 

The terminal allows you to access two different character 
sets by using the s i (selects the current GO character set) 
and s o (selects the current G1 character set) commands. 

The s i command invokes the current GO character set 
installed in the terminal. This may be the 94 graphic charac- 
ters from the ASCII character set, or the corresponding 94 
characters from the United Kingdom, French, Swedish, 
Danish/Norwegian, German, supplementary, or special rul- 
ings character sets; each of these character sets is desig- 
nated by connecting a standard or optional keyboard to the 
terminal or by using the SCS (Select Character Set) com- 
mand. Appendix B of this manual lists these character sets. 

To select the G1 character set, use the s o (Shift Out) 
character. 



SM (Set Mode) 

Sets one or more modes. 
Host Syntax 



E c[ mode h 



mode: The terminal mode or modes that you want to set. 
Default: Omitted = (not a valid parameter) 

Each mode to be set is specified by a separate parameter. 
You can set one or more modes by entering more than one 
parameter separated by semicolons. If you are setting more 
than one mode, any parameters that begin with ?, <, = , or 
> should be at the start of the list of parameters. A mode 
remains set until you reset it with an RM (Reset Mode) com- 
mand. Refer back to Table 4-2 (under RM command) for an 
explanation of the mode parameters. 



SL (Scroll Left) 

Moves the contents of the visible dialog area to the left. 
Host Syntax 



*c\ number-of-columns s p<s 



number-of-columns: Specifies the number of columns to 

scroll left. 

Default: Omitted or = 1 

The SL command moves the entire contents of the visible 
dialog area to the left by the specified number of columns. 
You can scroll horizontally only when Column mode is set to 
1 32. Since the cursor moves with the text, the cursor may 
disappear from the screen. Unlike vertical scrolling, the ter- 
minal will not automatically scroll left or right to keep the 
cursor in view. 

To scroll horizontally, you must give the SCROLL LEFT or 
SCROLL RIGHT command (or you can use the joydisk). 
However, an automatic scroll left may occur when you make 
the dialog area visible with the DIALOG key; if the cursor is 
in Columns 81—132, the terminal will scroll left to bring the 
rightmost column into view. 



s o (Shift Out Character) 

Invokes the G1 character set. 

The terminal allows you to access two different character 
sets by using the s i (selects the current GO character set) 
and s o (selects the G1 character set) commands. 

The s o command invokes the the G1 character set. When a 
keyboard is plugged into the terminal, the character set 
associated with that keyboard is designated as both the GO 
and the G1 set. You may use the SCS (Select Character Set) 
command to designate a different character set than the 
one associated with the current keyboard. Appendix B lists 
the contents of all the available character sets. 

To select the GO character set, use the s i (Shift In) character. 



s p (Space Character) 

Moves the cursor one character position to the right or 
inserts a s p (Space) character. 

If Overstrike mode is enabled (TEKORM is reset), s p moves 
the cursor one character to the right. The s p character does 
not replace the character, if any, at the cursor position. 

If Replace mode is enabled (TEKORM is set), s p replaces 
any character at the cursor position. 
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SR (Scroll Right) 

Moves the contents of the visible dialog area to the right. 
Host Syntax 



E c[ number-of-columns s p A 



number-of-columns: Specifies the number of columns to 
scroll right. 

uciaun. x^iiihicu Oi \j — i 

The SR command moves the entire contents of the visible 
dialog area to the right by the specified number of columns. 
Since the cursor moves with the text, the cursor may disap- 
pear from the screen. Unlike vertical scrolling, the terminal 
will not automatically scroll left or right to keep the cursor in 
view. 

To scroll horizontally, you must give the SCROLL LEFT or 
SCROLL RIGHT command (or you can use the joydisk). 
However, an automatic scroll right may occur when you 
make the dialog area visible with the DIALOG key; if the cur- 
sor is in Columns 1 —80, the terminal will scroll right to bring 
the rightmost column into view. 



TBC (Tab Clear) 

Clears one or more tab stops. 
Host Syntax 



E c[ tab-clear-extent g 



tab-clear-extent: Clears the tabs as indicated by the param- 
eter values. Refer to Table 4-6 for an explanation of these 

(JCllCllllCLdO. 

Default: Omitted = 



Table 4-6 
TAB CLEAR COMMAND PARAMETERS 



Parameter 


Description 





Clears the horizontal tab stop at the cursor 
position 


2 


Clears all horizontal tab stops 


3 


Clears all horizontal tab stops 



SU (Scroll Up) 

Scrolls lines up. 
Host Syntax 



E c[ number-of-lines S 



number-of-lines: The number of lines to scroll toward the 
top of the screen. 
Default: Omitted or = 1 

The SU (Scroll Up) command shifts all lines in the dialog 
buffer upward by the specified number («) of rows. The n 
lines at the top margin are rolled out of sight and n lines are 
rolled into view at the bottom margin. 
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TEKDHL (Double Height Line) 

Causes the line containing the cursor to become the top or 
bottom half of a double-height, double-width line. 

Host Syntax 



Top Half Bottom Half 
E c#3 E c#4 



Both lines that receive these commands must contain the 
same characters. Since using double-width characters 
halves the number of characters per line, characters to the 
right of screen center are lost if the line was previously sin- 
gle width. 

To make an exact hardcopy of a double-height, double- 
width line, you must make a screen copy. Making a dialog 
copy will copy each character of the top-half line as a regu- 
lar size character followed by a space; the bottom-half line 
becomes a blank line. (See the Tek mode HARDCOPY com- 
mand description for additional details about making screen 
and dialog copies.) 

This command affects only the current line. The line will 
retain this attribute until the line is deleted or until the termi- 
nal receives another line attribute command (TEKDHL, 
TEKDWL, or TEKSWL). 



This command affects only the current line. The line will 
retain this attribute until the line is deleted or until the termi- 
nal receives another line attribute command (TEKDHL, 
TEKDWL, or TEKSWL). 

Since using double-width characters halves the number of 
characters available per line, characters to the right of 
screen center are lost if the line was previously single width. 

To make an exact copy of a double-width line, you must 
make a screen copy. Making a dialog copy will copy each 
character in the line as a regular size character followed by 
a space. (See the Tek mode HARDCOPY command 
description for additional details about making screen and 
dialog copies.) 



TEKID (Identify Terminal) 

Tells the terminal to report what type of terminal it is. 
Host Syntax 



E cZ 



This command causes the same response as the Ansi mode 
DEVICE ATTRIBUTES (DA) command with a parameter 
ofO. 



TEKDWL (Double Width Line) 

Causes the line containing the cursor to become a double- 
width, single-height line. 

Host Syntax 



E c#6 



NOTE 

The TEKID command is provided in Ansi mode only 
for compatibility with programs written for VT100 
terminals. Avoid using this command if you can; its 
use violates ANSI and ISO standards. 
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TEKKPAM (Keypad Application Mode) 

Places the terminal in Keypad Application mode. 
Host Syntax 



E c = 



Setup Syntax 



KEYPADMODE APPLICATION 



The TEKKPAM command causes the numeric keypad to 
send characters distinct from the numeric keys on the main 
keyboard. This means that when you press the 6 key on the 
numeric keypad, a different code is generated than when 
you press the 6 key on the main keyboard. Refer to Table 
4-7 for an explanation of these codes. 

When the terminal is turned on, it is in Keypad Numeric 
mode. 



TEKKPNM (Keypad Numeric Mode) 

Places the terminal in Keypad Numeric mode. 
Host Syntax 



=c> 



Setup Syntax 



KEYPADMODE NUMERIC 



This command causes the keys on the numeric keypad and 
function keys F5 through F8 to return to their default mean- 
ings, as shown in the righthand column of Table 4-7. If the 
keys have been programmed and key expansions are 
enabled, the keys transmit their programmed meanings 
instead. 

When the terminal is turned on, it is Keypad Numeric mode 
(keys produce their default meanings). 



Table 4-7 
NUMERIC KEYPAD PROGRAMMING CODES 



Numeric 
Keypad Key 


Characters Sent in 
Application Mode 


Characters Sent in 
Numeric Mode 





E cOp 





1 


E cOq 


1 


2 


E cOr 


2 


3 


E cOs 


3 


4 


E cOt 


4 


5 


E cOu 


5 


6 


E cOv 


6 


7 


E cOw 


7 


8 


E cOx 


8 


9 


E cOy 


9 


- 


E cOm 


- 


, 


E cOI 


, 




E cOn 




ENTER 


E cOM 


C R 


F5 


E cOP 


^OP 


F6 


E cOQ 


E cOQ 


F7 


E cOR 


E cOR 


F8 


E cOS 


E cOS 



TEKRC (Restore Cursor) 

Restores the cursor position, graphic rendition, character 
set, and Origin mode previously saved using the TEKSC 
(Save Cursor) command. 

Host Syntax 



E c8 



If the TEKSC (Save Cursor) command is not used first, then 
TEKRC (Restore Cursor) returns the cursor to the Home 
position and restores the power-up graphic rendition, char- 
acter set, and Origin mode. 
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SCREEN EDITING SUPPORT 
ANSI — TEKSC (Save Cursor) 



TEKSC (Save Cursor) 

Saves the cursor position, graphic rendition, character set, 
and Origin mode. 

Host Syntax __^ 



E c7 



The TEKSC (Save Cursor) command saves information 
about the cursor position, graphic rendition, character set, 
and Origin mode in the terminal's memory. This saved infor- 
mation may be restored using the TEKRC (Restore Cursor) 
command. 



TEKSWL (Single Width Line) 

Causes the line containing the cursor to become a single- 
width, single-height line. 

Host Syntax 



E c#5 



The cursor retains its current column number. This is the 
default for all new lines in the dialog area. This command 
affects only the current line. The line will retain this attribute 
until the line is deleted or until the terminal receives another 
line attribute command (TEKDHL, TEKDWL, or TEKSWL). 



TEKSTBM (Set Top and Bottom Margins) 

Sets the dialog buffer's edit margins. 

Host Syntax 



E c[ top-margin ; bottom-margin r 



Setup Syntax 



EDITMARGIN top-margin, bottom-margin 



top-margin: The row number of the top margin. 
Default: Omitted or = 1 

bottom-margin: The row number of the bottom margin. 
Default: Omitted or = The number of lines visible in the 
dialog buffer (DALINES). 

The parameter value for the top margin specifies which row 
of the dialog buffer becomes the top line of the scrolling 
region. Similarly, the value for the bottom margin specifies 
the row of the dialog buffer for the bottom line of the 
scrolling region. 

The rows in the dialog buffer above the top margin and the 
rows below the bottom margin become fixed regions. No 
scrolling actions occur in the fixed regions. 



v t (Vertical Tab Character) 

The v t character moves the cursor down one line without 
affecting the cursor position on the line. 



_ (Underscore Character) 

If Overstrike mode is enabled (TEKORM is reset), the cur- 
rent character is underlined and the cursor advances to the 
next character. 

If Replace mode is enabled (TEKORM is set), the under- 
score character replaces the current character. 
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VT52 COMMANDS 

The VT52 commands that foiiow can be executed only whiie 
the terminal is in VT52 mode. You can put the terminal in 
VT52 mode by: 

• Entering CODE VT52 while in Setup mode 

• Sending an RM command ( E c[?21) from the host while in 
Ansi mode 

• Sending a SELECT CODE command ( E c%!3) from the 
host while in Tek or Ansi mode 

Once the terminal is in VT52 mode, it will recognize only 
VT52 commands (which are explained here), and the com- 
mands SELECT CODE and REPORT SYNTAX MODE, both 
of which work in all modes. 



CURSOR DOWN 

Moves the cursor down one line without moving it 
horizontally. 



Host Syntax 



E cB 



The cursor moves with respect to the dialog buffer and 
stops at the last row of the dialog buffer. However, if margins 
are set and the cursor is within the scrolling region, the cur- 
sor stops at the bottom margin of the scrolling region. 



CURSOR LEFT 

Moves the cursor one column to the left. 
Host Syntax 



E cD 



The cursor does not move beyond the leftmost column 
(Column 1). 

This command works just like the Ansi mode command 
CUB (Cursor Backward) with a parameter of 1 . 



SCREEN EDITING SUPPORT 
VT52 — CURSOR UP 



CURSOR RIGHT 

Moves the cursor one column to the ri n ht. 
Host Syntax 



E cC 



The cursor does not move beyond the rightmost column. If 
Column mode is set to 1 32, the cursor may disappear from 
the screen. This command will not scroll horizontally to 
keep the cursor in view. 

This command works just like the Ansi mode command 
CUF (Cursor Forward) with a parameter of 1 . 



CURSOR TO HOME 

Moves the cursor to the Home position. 
Host Syntax 



E cH 



The home position is Row 1 , Column 1 of the dialog buffer. 

CURSOR UP 

Moves the cursor up one line without moving it horizontally. 
Host Syntax 



E cA 



The cursor moves with respect to the dialog buffer and 
stops at the first row of the dialog buffer. However, if margins 
are set and the cursor is within the scrolling region, the cur- 
sor stops at the top margin of the scrolling region. 
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SCREEN EDITING SUPPORT 

VT52 — DIRECT CURSOR ADDRESS 



DIRECT CURSOR ADDRESS 

Moves the cursor to the specified line and column. 



Host Syntax 



E cY line; column 



line: An ASCII character that represents the line position 
number plus 31 . The maximum line range is 96, even if the 
dialog buffer is larger. 

column: An ASCII character that represents the column 
number plus 31 . The maximum column range is 80, even if 
Column mode is set to 1 32. 

For example, to move the cursor to Line 3, Column 1 , give 
the command e cY" s p since the decimal equivalent of " is 34 
(3 + 31) and the decimal equivalent of s p is 32(1 + 31). If a 
parameter is out of range, the cursor will not change posi- 
tion for that parameter. However, the cursor will move to the 
other parameter position if it is within the range. 



ENTER ALTERNATE KEYPAD MODE 

Causes the numeric keypad keys and Function Keys F5 ■ 
F8 to assume their Alternate Keypad mode meanings 
(shown in Table 4-8). 



Host Syntax 



E c = 



Any other meanings you program into these keys cannot be 
used as long as the terminal is in Alternate Keypad mode. 

This command works like the Ansi mode command 
TEKKPAM (Keypad Application Mode). 



Table 4-8 
ALTERNATE KEYPAD PROGRAMMING CODES 



Numeric 

Keypad 

Key 


Characters Sent 
as Factory 
Default 


Characters Sent 
in Alternate 
Keypad Mode 








E c?p 


1 


1 


E c?q 


2 


2 


E c?r 


3 


3 


E c?s 


4 


4 


E c?t 


5 


5 


E c?u 


6 


6 


E c?v 


7 


7 


E c?w 


8 


8 


E c?x 


9 


9 


E c?y 


- 


- 


E c?m 


, 


, 


E c?l 






E c?n 


ENTER 


C R 


E c?M 


F5 


E cP 


E cP 


F6 


E cQ 


E cQ 


F7 


E cR 


E cR 


F8 


E cS 


E cS 



ENTER ANSI MODE 

Places the terminal in Ansi mode. 
Host Syntax 



=c< 



The terminal will interpret all subsequent commands 
according to ANSI Standard X3.64. 
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ENTER GRAPHICS MODE 

Causes the Rulings character set to be selected as the GO 
character set. 

Host Syntax 



=cF 



The terminal will remain in Graphics mode until you issue 

on EYITf5RAPHIGQ M<~>nF rnmmanri If unn issnethe 

ENTER ANSi MODE command while the terminai is stiii in 
Graphics mode, the terminal will exit Graphics mode before 
it exits VT52 mode. 



ERASE TO END OF LINE 

Erases all characters from the cursor to the end of the 
current line. 



Host Syntax 



E cK 



The cursor position does not change. 

This command works like the Ansi mode command EL 
(Erase in Line) with a parameter of 0. 



ERASE TO END OF SCREEN 

Erases all characters from the cursor to the end of the 
screen. 



Host Syntax 



E cJ 



The cursor position does not change. 

This command works like the Ansi mode command ED 
(Erase in Display) with a parameter of 0. It erases text from 
the cursor position to the end of the dialog buffer, so it 
makes no difference if margins are set. 



EXIT ALTERNATE KEYPAD MODE 

Causes the numeric keypad keys and Function Keys 
F5 - F8 to assume their factory default meanings, or their 
programmed meanings if they have been programmed. 

Host Syntax 



c c> 



Factory default meanings are shown in Table 4-8 (under 
ENTER ALTERNATE KEYPAD MODE). 

This command works like the Ansi mode command 
TEKKPNM (Keypad Numeric Mode). 



EXIT GRAPHICS MODE 

Restores the GO character set that was in effect before the 
current ENTER GRAPHICS MODE command was issued. 



Host Syntax 



E cG 



IDENTIFY 

Identifies the terminal to the host. 
Host Syntax 



E cZ 



When the host issues this command, the terminal sends its 
identifier escape sequence E c/Z to the host. 



REVERSE LINEFEED 

Moves the cursor up one line without affecting the cursor 
position on the line. 



Host Syntax 



E cl 



Follow the E c with an uppercase i. 
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Section 5 

4100-STYLE PARAMETER TYPES, 
COMMANDS, AND REPORTS 



INTRODUCTION 

This section contains detailed descriptions of the terminal's 
4100-style parameter types, commands, and reports. The 
explanations are for both the terminal's Host syntax and 
Setup mode syntax. 

The terminal executes 4100-style commands when it is in 
Tek mode, which you specify with the SELECT CODE 
command. 

The first part of this section includes descriptions of param- 
eter types associated with 4100-style commands. The 
parameter types are explained in alphabetical order. Com- 
mands issued from the host use special encoding for 
parameter values. Setup mode commands use simple 
English words or numbers as parameters. 

The second part of this section contains explanations of 
41 00-style commands and of reports associated with cer- 
tain commands. Most commands have two forms: one used 
for sending the command from the host, and the other used 
locally in the terminal's Setup mode. Since the host form is 
in a cryptic opcode format, it is given a descriptive command 
name to clarify what the command does. The associated 
Setup mode command accomplishes the same function 
locally; it has an English-style name that identifies the com- 
mand's purpose. The command explanations are given 
alphabetically according to the descriptive command name. 



4100-STYLE PARAMETER TYPES 

The following explanations document the various types of 
values used for the 4100-style parameters. 



Character Array Parameters in Host Syntax 

The character array parameter type allows you to send a list 
of characters as one parameter. This parameter type occurs 
only in the Host syntax form of a command. 



The first character in the array is an encoded integer indica- 
ting the length of the array. The integer is followed by the 
ASCII characters in the array. 

The following example shows how the phrase PRESS 
RETURN KEY would be sent as a character array: 

AOPRESS RETURN KEY 



Character Parameters in Setup Syntax 

The Setup mode form of commands have three kinds of 
character parameters: small integer, string, and character. 



The Small Integer Parameter. The small integer parameter 
type corresponds to all characters listed on a standard 
ASCII chart. A small integer parameter has a range of N u to 
d t; it has an ADE range of to 1 27. When you specify a 
small integer parameter, you can use either the actual char- 
acter or its ADE value. 



The String Parameter. Some commands use an undelimi- 
ted string. The word "undelimited" means that the parame- 
ter does not require special characters to distinguish it from 
other character strings. A string parameter requires that you 
specify actual characters rather than ADE values. 



The Character Parameter. The character parameter type 
corresponds to the printing characters listed on a standard 
ASCII chart. A character parameter has a range of s p to ~ 
(tilde); it has an ASCII decimal equivalent (ADE) range of 32 
to 1 26. When you specify a character parameter, you can 
use either the actual character or its ADE value. 

All three of these parameter types can be used as delimited 
parameters. When parameters are delimited, the first and 
last characters have a special meaning to distinguish that 
group of characters from others. A delimited parameter can 
only include ASCII characters, not ADE values. 
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41 00 COMMANDS AND REPORTS 
PARAMETER TYPES 



For example, in the Setup syntax of the SET EOF STRING 
command, you specify up to ten small integer characters to 
indicate the end-of-file marker. The delimiter can be any 
character — it is always the first character after the space 
following the command name. The delimiter is followed by 
up to ten alphanumeric characters and that group of charac- 
ters is terminated by the same delimiter. The following com- 
mand illustrates a delimited character parameter: 

EOFSTRING THE END' 



Integer Parameters in Host Syntax 

In Host syntax, integers are encoded as a series of one, two 
or three characters. For example, Figure 5-1 illustrates that 
the integer -241 3 is encoded as: 

BV- 

First, the decimal numeral must be translated into binary. 
Then the digits of the binary numeral are encoded (see 
Figure 5-1). 

Hi-I: There may be zero, one or two Hi-I characters, 
depending on the value of the integer. The Hi-I 
characters are: 

Idddddd 

The first bit is always set to 1 ; the next six bits are 
the next six most significant bits in the binary 
numeral. In the example in Figure 5-1 , the Hi-I 
character is: 

1000010 



This corresponds to the B character on an ASCII 
chart. 

The second Hi-I character is: 
1010110 

This corresponds to the V character on an ASCII 
chart. 

Lo-I: The Lo-I character may be the only character. It 
contains the sign bit and the four least-significant 
bits of the integer: 

01 sdddd 

The first two bits are always set to and 1 ; the third 
bit represents the sign of the integer. A negative 
integer is represented by a 0; a positive integer is 
represented by a 1 . The next four characters are 
the least significant bits of the integer. 

In the example in Figure 5-1 , Lo-I would be: 
0101101 

This corresponds to the - (hyphen) character on an 
ASCTlchart. 



Decimal -2413 

= binary 00010 010110 1101 

Hi-I Hi-I 



Decimal -2413 
Encoded form BV- 



Lo-I 






= 


ASCII 
Character 

B 

V 


ADE 


Hi-I 


\ 1 i 


000010 


66 










Hi-I 


1 


010110 


86 


Lo-I 


01 


f I 1101 \ 
sign 


45 



Figure 5-1 . How Integers Are Encoded. 
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Integer Report Parameters in Host Syntax 

When the terminal sends integers to the host, it sends them 
encoded as three characters in an integer report. The way 
the terminal encodes integer reports is similar, but not iden- 
tical, to the way the host encodes integer parameters (see 
the immediately preceding paragraphs). Integer report 
parameters have these characteristics: 

• The terminal may include an EOL string, but sends it 
only if there is no other way to avoid exceeding the cur- 
rent maximum line length. 

9 Unlike integer parameters, integer reports always have 
three characters. 

• The encoding scheme for an integer report's Lo-I charac- 
ter is identical to that of the integer parameter. 

• The encoding scheme for an integer report's two Hi-I 
characters uses a different "offset" than for an integer 
parameter. In an integer parameter's Hi-I character, 64 is 
added to a six-bit binary numeral to form the ASCII deci- 
mal equivalent of the Hi-I character (this is the 1 seen at 
the beginning of the Hi-I's in Figure 5-1). In an integer 
report's Hi-I characters, 32 (rather than 64) is added to 
the six-bit binary numeral. 

If, for example, we use the binary representation of -241 3 
shown in Figure 5-1 , the first Hi-I character will be: 



Six-bit binary 
Add offset of 32 



000010 
+ 0100000 
= 0100010 
= ASCII character " 



i he second hi-i cnaracter win De: 
Six-bit binary 010110 



Add offset of 32 



+ 0100000 
= 0110110 
= ASCII character 6 



The Lo-I character is encoded in the same way as the inte- 
ger parameter and will be: 

0101101 
= ASCII character - 

Thus, if the terminal sends the number -241 3 to the host as 
an integer report, it encodes that number as "6-. 



Integer Array Parameters in Host Syntax 

Some commands take integer array parameters, integer 
array parameters consist of sequences of integer parame- 
ters. The first integer tells how many items are in the array; 
subsequent integers represent individual array items. You 
encode each item in the array the same way you encode a 
single integer, as described under "Integer Parameter Type 
in Host Syntax." 

For example, you would send the array of integers (1 , 5, -1 , 
16) to the terminal as follows: 



integer array: (1,5,-1,16) 



= integer:4 (the count of 4) 

integer: 1 

integer.5 

integer:-1 

integer: 16 
= 415SA0 



Integer Parameters in Setup Syntax 

Whenever you use an integer parameter in Setup syntax, 
simply enter the value. For example, to set both the transmit 
and receive rate to 2400 using the BAUDRATE Setup com- 
mand, enter: 

BAUDRATE 2400 2400 



Key Specifiers in Setup Syntax 

The key specifier parameter type is used in the DEFINE 
MACRO and DEFINE NONVOLATILE MACRO commands. 

See Table 5-2 (under DEFINE MACRO) for the ASCII deci- 
mal equivalents (ADE) and macro numbers referred to in the 
following paragraphs. 

Key specifiers for keys labeled with ASCII characters can be 
the ASCII character itself or a two- or three-digit ADE value 
or a macro integer number. 

Function keys are represented by macro numbers or by a 
two-character abbreviation. The abbreviations F1 through 
F8 designate the unshifted versions of the function keys; 
S1 through S8 specify the shifted versions of those keys. 
The Ctrl and Shift-Ctrl versions of those keys are specified 
by macro numbers only. 



The numeric keypad, special function keys, and joydisk are 
specified by macro numbers. 
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Keywords in Setup Syntax 

The keyword parameter type is used in Setup mode only. 
Keyword parameters specify what action you want a com- 
mand to perform. When you use a keyword, you can spell 
out the entire word or just as many characters as necessary 
to distinguish that keyword from other keywords associated 
with the command. 



XY-Coordinates in Host Syntax 

The host must encode each xy-coordinate into one to five 
ASCII characters. The valid range of xy-coordinates is to 
4095. The xy-coordinates (53,1 000), for example, would be 
encoded and sent to the terminal as the following 
characters: 
'az s pM 

Figure 5-2 illustrates how the encoding process works. 
First, the decimal numeral is translated into a 1 2-bit binary 
numeral. Then the digits of the binary numeral are encoded. 
In the encoding process, the bits are divided into Hi, Lo, 
and Extra bytes. 



In the example in Figure 5-2, decimal 53 translates to 
binary: 

00000 0110101 

Decimal 1 000 translates to binary: 
00111 1101 00 

The digits are encoded and transmitted in the order in which 
the following explanations are given: 

Hi-Y: Contains the most significant five bits of the binary 
numeral representing the y-coordinate of the xy- 
parameter. The seven-bit Hi-Y character (exclud- 
ing the parity bit) has the following format: 

01 yyyyy 



X-Coordinate - decimal 53 
= binary 00000 01101 

Hi-X 



(53, 1000) 



01 



Lo-X Second 
Extra 



Hi-Y 


| 01 J 


00111 j 

First Second 
Extra Extra 




Extra 


110 


oo .; 01 


= 










Lo-Y 


11 


11010 | 


= 










Hi-X 


01 


00000 


= 


Lo-X 


10 


01101 5 

XY-Coordinate 





Y-Coordinat€ 


= decimal 1000 




= binary 


00111 


11010 00 






Hi-Y 


Lo-Y First 
Extra 


ASCII 








Character 




ADE 




t 




39 




a 




97 




z 




122 




s p 
M 




32 

77 





'az s pM 



Figure 5-2. How XY-Coordinates Are Encoded. 
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The first two bits must be set to 1 , as shown. The Hi-X: 

characters "y y y y y" represent the five most sig- 
nificant bits of the y-coordinate, in the example in 
Figure 5-2, this byte is: 

0100111 

This corresponds to the apostrophe ( ' ) character. 

You can omit the Hi-Y byte if the high-order five bits 
of the y-coordinate has not changed since the last 
xy-coordinate was sent. 

aiici. \sv\ iiciin^ inc icaoi-oiyniiiv^aiii twu una ui uicX-cuiu 

y-coordinates. The seven-bit ASCII character has 
the following format: 

1 1 Oyyxx 

The first three bits must be set to 1 1 0, as shown. 
The characters "y y x x" represent the two least Lo-X: 

significant bits of the y- and x-coordinates, respec- 
tively. In the example in Figure 5-2, this byte is: 

1 1 00001 

This corresponds to the letter a on the ASCII chart. 

You can omit the Extra byte if you only want to 
send coordinates with 1 bits of precision or if the 
two least significant bits of the x- or y-coordinate 
have not changed since the last xy-coordinate. If 
you do send the Extra byte, you must follow it with 
a Lo-Y bite. 

Lo-Y: Contains the intermediate five bits of the y-coordi- 
nate. The seven-bit ASCII character has the follow- 
ing format: 

1 lyyyyy 

The first two bits must be set to 1 1, as shown. The 
characters "y y y y y" represent the five intermedi- 
ate bits of the y-coordinate. In the example in 
Figure 5-2, this byte is: 

1111010 

This corresponds to the letter z on the ASCII chart. 

You can omit the Lo-Y byte if the following condi- 
tions are all true: 

• These five bits have not changed since the last 
xy-coordinate. 

• You are not sending the Extra byte. 

• You are not sending the Hi-X byte. 



Contains the most significant five bits of the x- 
coordinate of the xy-parameter. The seven-bit 
ASCI! character has the following format: 

1 xxxxx 

The first two bits must be set to 1 , as shown. The 
characters "xxxx x" represent the five most sig- 
nificant bits of the x-coordinate. In the example in 
Figure 5-2 this byte is: 

0100000 

This corresponds to the ASCII s p (space) character. 

You can omit the Hi-X character if the x-coordi- 
nate's most significant bits have not changed from 
the last xy-coordinate sent. If you do send the Hi-X 
character you must precede it with the Lo-Y byte. 

Contains the intermediate five bits of the x-coordi- 
nate. The seven-bit ASCII character has the follow- 
ing format: 

1 Oxxxxx 

The first two bits must be set to 1 0, as shown. The 
characters "xxxx x" represent the five intermedi- 
ate bits of the x-coordinate. In the example in 
Figure 5-2, this byte is: 

1 001 1 01 

This corresponds to the letter M on the ASCII 
chart. 

This character must always be sent, since it termi- 
nates the xy-parameter sequence. 

NOTE 

Since the Lo- Y and Extra bytes each have 
high-order bits of "1 1 ", d t (binary 111111 
1) could appear as a Lo- Y or Extra byte. This 
presents a problem for hosts that use d t as a 
filler character. 

If your host uses d t as a filler, have the host do 
the following things: 

• Send the two-character string E c ? instead of 
d t since the terminal recognizes that string 
as a synonym for d t. 

• Send the terminal an IGNORE DELETES 
command to cause the terminal to ignore all 
d t characters sent from the host. 
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4100-STYLE COMMAND AND 
REPORT DESCRIPTIONS 

This part of the section describes each of the terminal's 
4100-style commands and reports. The commands are 
presented alphabetically according to the descriptive 
names associated with the Host syntax. Figure 5-3 shows 
the format in which commands are explained. 

Command Conventions 

There are four different kinds of 41 00-style escape 
sequence commands: 

• A single character 

• The E c character followed by one character 

• The E c character followed by two characters 

• The E c character followed by two characters and one or 
more parameters 

Figure 5-3 illustrates the general syntax conventions used 
in this section of the manual. Almost every command in this 
section has a Host syntax form; many commands have both 
a Host syntax form and an English-style Setup syntax form. 
Some commands have just a Setup syntax form. 

The following points summarize the format illustrated in 
Figure 5-3. 

• The descriptive command name is shown in all upper- 
case characters. 

• Characters shown in bold type are those you must enter 
exactly as shown. 

• No spaces are allowed between the E c and following 
letters or parameters. 

• Parameter names are shown on separate lines and are 
separated by commas to make the command syntax 
easier to read. However, when entering commands, 
follow these rules: 

• In Setup mode, enter parameters on the same line. 
The first character after the command name must be 
a space; use one or more spaces or one comma to 
separate parameters. 

• In Host syntax, enter parameters on the same line 
with no spaces between any of the parameters. 

• Multiword items are joined by hyphens. For example, 
parameter-name and next-parameter-name are single 
items described by two or more words. 

• Three periods following a parameter (. . .) indicate that it 
can be repeated. 



DESCRIPTIVE COMMAND NAME 

A short statement describing the purpose of the 
command. 

Host Syntax 



E cQQ parameter-name, 

next-parameter-name, 



Setup Syntax 



SETUPNAME parameter-name, 

next-parameter-name, 



parameter-name: parameter type; what it does. Ex- 
planations include the range. 
Defaults: Factory = The value assigned a param- 
eter when the terminal is 
shipped from Tektronix; 
parameters can be restored 
to this value by the Extended 
Self test program. 

Power-Up = The value assigned a param- 
eter when the terminal is first 
turned on. The term "Saved 
in memory" indicates that the 
parameter takes on the value 
saved in the terminal's non- 
volatile memory. 

Omitted = The value assigned a param- 
eter if the command is used 
and no value is specified for 
the parameter. 

next-parameter-name: The next parameter is 

explained. 

Defaults: Factory = Value 

Power-Up = Value 

Omitted = Value 



Figure 5-3. Command Description Format for 
411 0-Style Commands. 
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BEGIN PANEL BOUNDARY 

Starts a panel definition. 

Host Syntax 



E cLP first-point, 

draw-boundary 



Setup Syntax 



BCRIMDAMCI firet.nninf 

draw-boundary 



first-point: xy-coordinate; indicates the first point in a panel 
boundary. The valid range of values is through 4095 for 
both the x- and y-coordinate. 
Default: Omitted = (0,0) 

draw-boundary: integer; specifies that the panel boundary 
should be covered by the fill pattern, 1 specifies that the 
boundary should be displayed in the finished panel. 
Default: Omitted = 

After issuing BEGIN PANEL BOUNDARY, you can define 
the boundary of the panel in either of two ways: 

• Put the terminal in either Vector or Marker mode and 
then send the coordinates of the boundary line 
endpoints. 

• Use MOVE and DRAW commands to define the bound- 
ary line. 

You do not need to create the panel's last boundary seg- 
ment. When the terminal receives END PANEL, it closes the 
panel and fills it with the fill pattern specified in the most 
recent SELECT FILL PATTERN. 

You can define a panel when the terminal is in Marker 
mode. However, you cannot draw a marker during a panel 
definition when the terminal is in Marker mode. 



Multiple Panel Boundaries. You can create a panel with 
multiple boundaries, as shown in Figure 5-4. To do this, 
send another BEGIN PANEL BOUNDARY when you want to 
start the second boundary (do not use END PANEL to close 
the first boundary). The second BEGIN PANEL BOUNDARY 
closes the first boundary and starts another boundary at the 
specified position. When you issue END PANEL, the last 
boundary is closed and the entire panel defined by the 
multiple boundaries is filled. 



BEGIN PIXEL OPERATIONS 
(Requires Optional Pixel ROMs) 

Sets three parameters for use in subsequent RASTER 
WRITE, RUNLENGTH WRITE, RECTANGLE FILL, and 
PIXEL COPY commands. 

Host Syntax 



E cRU 



surface-number, 

ALU-mode, 

bits-per-pixe! 



Setup Syntax 



PXBEGIN 



surface-number, 

ALU-mode, 

bits-per-pixel 



surface-number: integer; valid values are -1 , 0, and 1 ; spec- 
ifies the surface on which subsequent pixel operations 
commands will write (or read) their data. Since Surface 1 is 
the terminal's only surface, all parameter values mean 
Surface 1 . (Other Tektronix 41 00 Series terminals may have 
additional surfaces, so the surface parameter is included 
here for compatibility). 
Defaults: Factory = 1 

Power-Up = 1 

Omitted = 

ALU-mode: integer; valid values are 0, 7, 1 1 , 1 2, or 1 5; 
specifies arithmetic logic unit (ALU) writing mode. means 
no change to the existing ALU-mode. 7, 11, 12, and 15 
specify what function RASTER WRITE, RUNLENGTH 
WRITE, RECTANGLE FILL, and PIXEL COPY commands 
will use to modify the existing contents of the terminal's 
raster memory buffer. Table 5-1 lists the function that each 
ALU-mode parameter value selects. 
Defaults: Factory = 11 

Power-Up = 11 

Omitted = 

bits-per-pixel: integer; specifies the number of bits used 
to encode the color index for each pixel in subsequent 
RASTER WRITE and RUNLENGTH WRITE commands. 
Valid values are 0, 1 , 2, 3, 4, and 6; means no change. 
The command descriptions for RASTER WRITE and 
RUNLENGTH WRITE explain in greater detail how to use 
this parameter. 
Defaults: Factory = 6 

Power-Up = 6 

Omitted = 
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Table 5-1 
ALU VALUES 



ALU Mode 


Function 


Application 





no change 




7 


AXORB 
(exclusive OR) 


Fast Erase mode. Writes an image 
that you can later completely remove 
by repeating the same operation. 
That is because A = (A XOR B) XOR 
B. 


11 


B 


Replace mode. Replaces the exist- 
ing image with the new pixels. This is 
the default ALU-mode. 


12 


AANDB 


Performs a logical AND function on 
the pixel color indices and displays 
the results. 


15 


AORB 


Writes the new image on top of the 
existing image. Pixel values of in 
the command string do not affect 
raster memory. 



CANCEL 

Resets several terminal parameters and modes. 
Host Syntax 



E cKC 



Setup Syntax 



CANCEL 



When you issue this command (which has the same effect 
as pressing the Cancel key) it: 

• Puts the terminal into Alpha mode and terminates all of 
the following modes: 

• Vector mode 

• Marker mode 

• GIN mode 

• Bypass mode 

• Prompt mode 

• Snoopy mode 

• Unlocks the keyboard 

• Terminates the copy or hardcopy functions if either is 
currently in progress 

• Empties the input/output queues 



CLEAR DIALOG SCROLL 

Clears (erases) the dialog buffer. 
Host Syntax 



E cLZ 



Setup Syntax 



CLEARDIALOG 



After the dialog buffer is cleared, the cursor returns to the 
home position (upper-left corner of dialog area). 

Issuing CLEAR DIALOG SCROLL has the same effect as 
pressing the terminal's D Eras key. 
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COPY 

Sends data from the host directly to an attached hardcopy 
unit. 

Host Syntax 



E cJC source, 
separator, 
destination 



Setuo Svntax 



COPY HO: TO HC: 



source: character array (string in Setup syntax); the only 
valid value is HO: (in uppercase or lowercase). 



separator, character array (string in Setup syntax); If you 
use it, the only valid value is TO (in uppercase or lower- 
case). Otherwise, specify an empty array. 

destination: character array (string in Setup syntax); the 
only valid value is HC: (in uppercase or lowercase). 

After the terminal receives this command, it passes all data 
it receives from the host directly to the hardcopy port. The 
host is responsible for sending data that is meaningful to the 
hardcopy unit. The copy terminates when the terminal 

HptprtQ an FOF t&r\r{-rttS\\Q\ ctrinn nrwhon the nnorntnr 

presses the Cancel key. For example: 
E cJC3HO:2to3HC: 

As in all Host syntax character arrays, the integers in this 
command indicate the length of the array that follows. 





.(1500,1851) 






(1500,1459) \ 

A\ 




/ (1333,1192) (1667,1 192) \ 




(1000,1000) 


(2000,1000) 


Setup Command 


Encoded Command From Host 




BEGINPANEL 1000,1000,1 


^LP'^z'Zl 


DRAW 1500,1851 


E cLF. In+W 




DRAW 2000,1000 


^LF'^z/T 




DRAW 1000,1000 


E cLF' z'Z 




BEGINPANEL 1333,1192,1 


E cLP)aj*Ml 




DRAW 1500,1459 


E cLF+ 1 I +W 




DRAW 1667, 1192 


E cLF)cj-@ 




END PANEL 


E cLE 


4526-1 4A 



Figure 5-4. Creating a Panel With Multiple Boundaries. 
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CRLF 

Specifies whether a c r character also implies an l f. 
Host Syntax 



E cKR crlf-mode 



Setup Syntax 



CRLF crlf-mode 



crlf-mode: integer (keyword in Setup syntax); or no means 
that c r does not imply c r l f, 1 or yes means that c r does 
imply c r l f. 
Defaults: Factory = (no) 

Power-Up = Saved in memory 

Omitted = 1 (yes) 

The term " c r does not imply c r l f" means that the c r char- 
acter is not interpreted as a carriage return and linefeed 
combination. 

The term " c Himpties °r l f" means that when the terminal 
receives a c r from the host or if the terminal is in Local mode 
and you press the Return key, the terminal interprets the c r 
as a carriage-return and line-feed combination. However, 
when you press the Return key, the l f character is not sent 
to the host.) 

Notice that if the parameter is omitted in Setup syntax it 
defaults to yes (the equivalent of 1 in Host syntax), but if it is 
omitted in Host syntax it defaults to (the equivalent of 
keyword no). 



DEFINE MACRO 

Creates and deletes macros, which can be expanded on 
command from the host, at the keyboard, or both. 

Host Syntax 



E cKD macro-number, 
macro-contents 



macro-number, integer (key specifier or integer in Setup 
syntax); specifies the name of the macro being defined. 
Valid values in the range -1 50 through 32767. A value of 
-1 deletes all volatile macros. 
Default: Omitted = 

macro-contents: integer array; specifies ASCII decimal 
equivalent (ADE) integers that represent the characters 
defining the macro. (Host syntax only.) 
Default: Omitted = Empty array 

string: delimited string; defines the macro. To use c r or the 
special editing characters in the macro definition, you must 
precede them with the literal character; see SET EDIT 
CHARS for information on the literal character. (Setup syn- 
tax only.) 

After a macro is defined, you can expand it either with 
EXPAND MACRO (for any macro) or by pressing a key 
corresponding to the macro number (for macros numbered 
-150 through 143, excluding -1). 

The following example shows how to define Macro 500 as 
"XYZ". 

t. Get ADE values for X, Y, and 2. 



racter 


ADE 


X 


88 


Y 


89 


Z 


90 



Convert the integers 500, 88, 89, and 90 to the termi- 
nal's integer format. 





Converted 


Integer 


Format 


500 


_4 


88 


E8 


89 


E9 


90 


E: 


Issue this command: 


E cKD. 


.43E8E9E: 



The integer 3 indicates that three values follow. This con- 
vention is followed for all integer arrays. 



Setup Syntax 



DEFINE macro-number, 
string 
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Volatile and Nonvolatile Macros. The Graphics Terminal 
section explains the difference between volatile and nonvol- 
atile macros. DEFINE MACRO defines and deletes only 
volatile macros. To define a nonvolatile macro, use DEFINE 
NONVOLATILE MACRO followed by SAVE NONVOLATILE 
PARAMETERS. 



Deleting Macros. To delete a specific macro in Setup syn- 
tax, enter DEFINE MACRO but don't include string after the 
macro number. In Host syntax, indicate a length of for 
macro-contents. The following example shows the com- 
mand in Host syntax form that deletes macro 500 (500 is 
_4 in integer format): 

E cKD_40 

To delete all macros, specify macro number -1 . The follow- 
ing Host syntax command deletes all macros (-1 is ! in 
integer format): 

E cKD!0 



Key Macros. Table 5-2 shows how integers from -1 50 to 
143 (excluding -1 ) correspond to the terminal's keys. 
Macros in this range are called key macros. Note that the 
integer for most keys is the ADE of the character the key 
normally produces. 

As shown in Table 5-2, each key is associated with up to four 
macros: unshifted, shifted, Ctrl, and Ctrl-shifted (in some 
cases two or more of the unshifted/shifted positions access 
the same macro). 

N*i+rt +l-t«+ »»it-t^i-t urn i /J/jfino q LfO" ■»"» Crtti in eimtpv \ir\i i r«or"» 
ULC LI IGLL VVI ICI I )UU UOlll IC <S t\^y ll I wQlU|J Ojf I nUrt jfwu wO.1 ■ 

either enter the key's ASCII decimal equivalent or just press 
the key (provided this key normally produces an ASCII 
character). Enter the macro's definition as a delimited string 
rather than an array of ADE integers. For example, to define 
the Q key to send the characters QUIT, enter: 

DEFINE Q "QUIT" 



Key-Execute Character. A special character, called the key- 
execute character, can be included in a key macro to cause a 
macro to be used only at the terminal instead of being sent 
to the host. Enclose the string you want used locally between 
two occurrences of the key-execute character named in the 
last SET KEY EXECUTE CHARACTER. 

If the characters between the key-execute characters form a 
valid command, the terminal executes the command. Other- 
wise, the macro is displayed as if the operator typed it. 



41 00 COMMANDS AND REPORTS 
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Table 5-2 



MACRO NUMBERS INVOKED BY KEYS 
(North American Keyboard) 



Keys 


Key 
Label 


Un- 
Shift 


Shift 


Ctrl 


Ctrl- 
Shift 


Standard 
Keyboard 


I 
[ 


91 


123 


27 


27 


and 

Function 

Keys 


! 
1 


49 


33 


49 


33 


@ 
2 


50 


64 


50 







# 
3 


51 


35 


51 


35 




$ 
4 


52 


36 


52 


36 




% 
5 


53 


37 


53 


37 




A 

6 


54 


94 


54 


30 




& 

7 


55 


38 


55 


38 




* 
8 


56 


42 


56 


42 




( 
9 


57 


40 


57 


40 




) 



48 


41 


48 


41 




- 


45 


95 


45 


31 




+ 


61 


43 


61 


43 




] 


93 


125 


29 


29 




Rub 
Out 


127 


-34 


-35 


-36 




Esc 


27 


-37 


-38 


-39 




I 


124 


126 


124 


126 




Q 


113 


81 


17 


17 




W 


119 


87 


23 


23 




E 


101 


69 


5 


5 




R 


114 


82 


18 


18 




T 


116 


84 


20 


20 




Y 


121 


89 


25 


25 




U 


117 


85 


21 


21 




I 


105 


73 


9 


9 




O 


111 


79 


15 


15 



(continued) 
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Table 5-2 (cont) 

MACRO NUMBERS INVOKED BY KEYS 
(North American Keyboard) 



Table 5-2 (cont) 

MACRO NUMBERS INVOKED BY KEYS 
(North American Keyboard) 



Keys 


Key 
Label 


Un- 
Shift 


Shift 


Ctrl 


Ctrl- 
Shift 


Standard 


P 


112 


80 


16 


16 


Keyboard 
and 

Function 
Keys (cont) 


\ 


92 


96 


28 


28 


Back 
Space 


8 


-40 


-41 


-42 




Line 
Feed 


10 


-43 


-44 


-45 




Tab 


9 


-46 


-47 


-48 




A 


97 


65 


1 


1 




S 


115 


83 


19 


19 




D 


100 


68 


4 


4 




F 


102 


70 


6 


6 




G 


103 


71 


7 


7 




H 


104 


72 


8 


8 




J 


106 


74 


10 


10 




K 


107 


75 


"11 


11 




L 


108 


76 


12 


12 






59 


58 


59 


58 






39 


34 


39 


34 




Return 


13 


-49 


-50 


-51 




Z 


122 


90 


26 


26 




X 


120 


88 


24 


24 




c 


99 


67 


3 


3 




V 


118 


86 


22 


22 




B 


98 


66 


2 


2 




N 


110 


78 


14 


14 




M 


109 


77 


13 


13 




< 


44 


60 


44 


60 




> 


46 


62 


46 


62 




? 

1 


47 


63 


47 


63 




Space 
Bar 


32 


-52 


-53 


-54 




F1 


128 


136 


-2 


-10 



Keys 


Key 
Label 


Un- 
Shift 


Shift 


Ctrl 


Ctrl- 
Shift 


Standard 


F2 


129 


137 


-3 


-11 


Keyboard 


F3 


130 


138 


-4 


-12 


Function 


F4 


131 


139 


-5 


-13 


Keys (cont) 


F5 


132 


140 


-6 


-14 




F6 


133 


141 


-7 


-15 




F7 


134 


142 


-8 


-16 




F8 


135 


143 


-9 


-17 




GEras 
Dialog 


-111 


-117 


-123 


-129 




Cancel 
Setup 


-112 


-118 


-124 


-130 




DCopy 
SCopy 


-113 


-119 


-125 


-131 




Color 
Select 


-114 


-120 


-126 


-132 




DEras 
SEras 


-115 


-121 


-127 


-133 




Break 


-116 


-122 


-128 


-134 


Numeric 





-55 


-69 


-83 


-97 


Keypad 
Keys 


1 


-56 


-70 


-84 


-98 


2 


-57 


-71 


-85 


-99 




3 


-58 


-72 


-86 


-100 




4 


-59 


-73 


-87 


-101 




5 


-60 


-74 


-88 


-102 




6 


-61 


-75 


-89 


-103 




7 


-62 


-76 


-90 


-104 




8 


-63 


-77 


-91 


-105 




9 


-64 


-78 


-92 


-106 






-65 


-79 


-93 


-107 




, 


-66 


-80 


-94 


-108 




- 


-67 


-81 


-95 


-109 




Ent 


-68 


-82 


-96 


-110 


Joydisk 


Right 


-135 


-139 


-143 


-147 


Positions 


Up 


-136 


-140 


-144 


-148 




Left 


-137 


-141 


-145 


-149 




Down 


-138 


-142 


-146 


-150 
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Each key-execute character the terminal encounters in a 
macro switches how key macros are used. If the terminal 
is sending macros to the host, the key-execute character 
means "use what follows locally." If the terminal is currently 
using macros locally, the key-execute character means 
"send what follows to the host." 

Always include the second key-execute character in the 
macro. If you omit the second key-execute character, 
subsequent macros are expanded at the terminal, even if 
they are intended for the host. This would continue until the 
terminal expands a macro that includes the key-execute 
character. 



NOTE 

This command must be followed by SAVE NONVOL- 
ATILE PARAMETERS to actually save or delete a 
macro in nonvolatile memory. 

To delete a single nonvolatile macro, use DEFINE 
NONVOLATILE MACRO specifying an array length of 
for macro-contents, and then use SAVE NONVOLATILE 
PARAMETERS. 



DRAW 



DEFINE NONVOLATILE MACRO 

Creates and deletes both the volatile and nonvolatile ver- 
sion of a macro. 

Host Syntax 



E cKO macro-number, 
macro-contents 



Draws a vector from the current graphics position to the 
specified location. 

Host Syntax 



E cLF position 



Setup Syntax 



DRAW position 



Setup Syntax 



NVDEFINE macro-number, 
string 



macro-number, integer (key specifier or integer in Setup 
syntax); specifies the name of the macro being defined. 
Valid values in the range -1 50 through 32767. A value of 
-1 deletes all macros, volatile and nonvolatile. 
Default: Omitted = 

macro-contents: integer array; specifies ASCII decimal 
equivalent (ADE) integers that represent the characters 
defining the macro. (Host syntax only.) 
Default: Omitted = Empty array 

string: delimited string; defines the macro. To use c r or the 
special editing characters in the macro definition, you must 
precede them with the literal character; see SET EDIT 
CHARS for information on the literal character. (Setup syn- 
tax only.) 

This command has the same effect as DEFINE MACRO, 
except it defines both the volatile and nonvolatile version of 
a macro, rather than just the volatile version. The Graphics 
Terminal section explains the difference between volatile 
and nonvolatile macros. 



position: xy-coordinate; indicates the point to draw to. The 

valid range of values is through 4095 for both the x- and 

y-coordinate. 

Default: Omitted = (0,0) 

DRAW has the same effect as sending the terminal an 
xy-coordinate when the terminal is in Vector mode. The 

tormingl r»on ovaM iif> PlD A\A/ inrHAn it ig in any r-r\r\ria flv/*ont 



Ansi or Bypass mode. 

The terminal draws the vector in the current line style and 
line index. Use SET LINE STYLE to set the line style. The 
line index is set with SET LINE INDEX. 

DRAW does not affect the terminal's mode. For example, if 
the terminal was in Alpha mode when it received the DRAW 
command, it stays in that mode. 

See the section called The Graphics Terminal 'for examples 
of how to create a line. 
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DRAW MARKER 

Draws a marker at a specified location. 
Host Syntax 



E cLH marker-position 



Setup Syntax 



MARKER marker-position 



marker-position: xy-coordinate; indicates the point where 
the marker is drawn. Valid range of values is to 4095 for 
both the x- and y-coordinate. 
Default: Omitted = (0,0) 

DRAW MARKER has the same effect as sending the termi- 
nal an xy-coordinate when the terminal is in Marker mode. 
The terminal can be in any mode except Ansi or Bypass 
mode when it executes DRAW MARKER. 

The marker specified by the most recent SET MARKER 
TYPE is drawn in the current line index; SET LINE INDEX 
sets the line index. 

DRAW MARKER does not affect the terminal's mode. For 
example, if the terminal is in Vector mode when it receives 
the DRAW command, it stays in that mode. 



ENABLE DIALOG AREA 

Enables or disables the dialog area. 
Host Syntax 



E cKA enable-mode 



Setup Syntax 



DAENABLE enable-mode 



enable-mode: integer (keyword in Setup syntax); or no 
disables the dialog area, 1 or yes enables the dialog area. 
Defaults: Factory = 1 (yes) 

Power-Up = Saved in memory 

Omitted = 1 (yes) 

When the dialog area is enabled and the terminal is in Tek 
mode, all alphatext is directed to the dialog buffer. (For the 
text to be seen, the dialog area must also be made visible; 
see SET DIALOG AREA VISIBILITY.) 

When the dialog area is disabled and the terminal is in Tek 
mode, the terminal emulates Tektronix 401 Series termi- 
nals, which do not have a dialog area. The terminal displays 
alphatext at the current position in the graphics area. 
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In Ansi mode, the terminal automatically directs text to the 
dialog area, regardless of whether or not the dialog area is 
enabled. 

Table 5-3 summarizes the effects of enabling and disabling 
the dialog area. 



Table 5-3 
EFFECTS OF ENABLE DIALOG AREA 



Feature 


Dialog Area Disabled 


Dialog Area Enabled 


Destination of 
Alphatext 


Current position in 
terminal space 


Current alpha cursor 
position in dialog area 


G Eras Key, 
S Eras Key, 
and PAGE 
Command 


Erases the graphics 
area of the screen 

Takes the terminal out 
of GIN mode 

Resets the terminal to 
Line Style 1 

Sets current position to 
home position (0,3071) 

Puts terminal in Alpha 
mode 


Erases the graphics 
area 


c r Character 


Puts terminal in Alpha 
mode 

Performs a carriage 
return action 

Resets the terminal 
Line Style to 1 

Takes the terminal out 
of GIN mode 


Iftheterminalisin 
Alpha mode, performs 
a carriage return in the 
dialog area 

No action if the terminal 
is in Vector or Marker 
mode 



ENABLE KEY EXPANSION 

Enables or disables key macros. 
Host Syntax 



E cKW switch 



Setup Syntax 



KEYEXPAND switch 



switch: integer (keyword in Setup syntax); 1 or yes enables 
key expansion, or no disables key expansion. 
Defaults: Factory = 1 (yes) 

Power-Up = 1 (yes) 

Omitted = 1 (yes) 

With DEFINE MACRO, you can define a key so that it pro- 
duces a character (or characters) other than the character it 
normally produces. ENABLE KEY EXPANSION enables or 
disables alternate key definitions. 

When key expansion is disabled, each key produces its 
normal character; that is, when you press a defined key, its 
macro is not expanded. When key expansion is enabled, 
macros are expanded as usual. 

This command does not delete macros. All key macros 
remain in memory and you can reenable them at any time. 

This command does not affect how the host uses macros. 
Even when key expansion is disabled, the host can still 
issue EXPAND MACRO to expand any macros, including 
those associated with keys. 
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ENABLE 4010 GIN 

Puts the terminal in Graphic Input (GIN) mode. 
Host Syntax 



When Graphics Input (GIN) mode is enabled, the graphics 
cursor appears on the screen. The terminal is now in GIN 
mode. The operator uses the joydisk to position the cursor 
and then presses any alphanumeric key. The terminal sends 
to the host a 401 GIN report indicating the xy-coordi nates 
of the cursor position and the identity of the key pressed. 
The graphics cursor then disappears and the terminal 
leaves GIN mode with the current position set to the cursor 
position. 

4010 GIN Report 

When the operator presses an alphanumeric key to send 
the cursor position to the host program, the terminal gener- 
ates a 4010 GIN report. This report tells the host program 
which key the operator pressed and the location of the 
crosshair cursor in terminal space. 



NOTE 

The 4010 GIN report regards terminal space as a 
1024x1024 area rather than the 4096x4096 area used 
when specifying locations for display. Reported coor- 
dinate values must be multiplied by 4 to give coordi- 
nates consistent with those used in other commands. 



The characters in the report are: 

1 . The ASCII character corresponding to the key the oper- 
ator pressed. 

2. The Hi-X character — the five most significant bits of 
x's binary value preceded by 01 . 

3. The Lo-X character — the five least significant bits of 
x's binary value preceded by 01 . 

4. The Hi-Y character — the five most significant bits of 
y's binary value preceded by 01 . 

5. The Lo-Y character — the five least significant bits of 
y's binary value preceded by 01 . 



X-Coordinate = decimal 50 

= binary 00000 01100 10 

Hi-X Lo-X Not 
Used 



(50,1000) 



Pressed 


f 1100001 S 








Hi-X 


01 


OOOOOj 








Lo-X 


[01 F 


01100 








Hi-Y 


01 


00111 








Lo-Y 


| 01 I 


11010 



GIN Report = 



Y-Coordinate = decimal 1000 
= binary 00111 11010 00 



Hi-Y 



ASCII 




Character 


ADE 


a 


97 


s p 


32 


. 


44 


' 


39 




58 



Lo-Y 



Not 
Used 



4526-38 



Figure 5-5. The GIN Cursor Position Report. 
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Since only the ten most significant bits of the x- and y-coor- 
dinate are reported, the reported values are an approxima- 
tion of the graphics cursor position. After a host program 
converts reported coordinates by multiplying the values by 
4, the derived values can differ from the true values by up to 
three units. 



Lo-Y Character. The Lo-Y character in the report consists of 
the prefix 01 followed by the five least significant bits in the 
binary numeral: 

0111010 
This corresponds to the colon ( : ) character. 



Example 

If the operator positions the crosshair cursor at the point 
(50,1000) and then presses the lowercase "a" key, the 
foiiowing report is sent (in 1 024x1 024 terminal space): 

a s p,': 

Figure 5-5 and the following explanations show why these 
five characters are sent. 



ASCII Character. The first character in the report is a, since 
that was the key the operator pressed. 



END PANEL 

Terminates a panel definition. 
Host Syntax 



E cLE 



Setup Syntax 



ENDPANEL 



Hi-X Character. The x-coordinate in this example is 50, 
which converts to binary 0000 001 1 001 0. The Hi-X charac- 
ter always has the prefix 01 and is followed by the five high- 
order bits in the binary numeral. So in this case, it is: 

0100000 
This is the space ( s p ) character. 



Lo-X Character. This character has the prefix 01 followed 

uy ii ic live? icaoi 01141 iiiiiseu iiuiioui 11 10 X-v/uuiuinaic. 1 1 no 

produces: 
0101100 



This is a comma ( , 



Hi-Y Character. The y-coordinate in this example is 1000, 
which converts to binary 001 1 1110 1000. The Hi-Y charac- 
ter always has the prefix 01 and is followed by the five high- 
order bits in the binary numeral. In this case, it is: 

0100111 
This corresponds to the apostrophe ( ' ) character. 



The panel boundary is closed, the panel is filled, and the 
current graphics position is set to the panel's first boundary 
point. 



ENTER ALPHA MODE 

Puts the terminal in Alpha mode. 
Host Syntax 



When the terminal is in Alpha mode, it interprets and dis- 
plays ASCII characters as text. Alpha mode is the terminal's 
power-up default. The text is displayed in the dialog area if 
the dialog area is enabled and visible. The u s character has 
an ADE value of 31 . 

The terminal leaves Alpha mode when it receives an 
ENTER VECTOR MODE or ENTER MARKER MODE 
command. 
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ENTER BYPASS MODE 

Puts the terminal in Bypass mode. 
Host Syntax 



When the terminal is in Bypass mode, characters coming 
from the host are ignored until the terminal receives the 
bypass-cancel character. The terminal automatically enters 
Bypass mode when it sends reports to the host except when 
the bypass-cancel character is a null (see SET BYPASS 
CANCEL CHARACTER). 

If the host echoes characters to the terminal as the host 
receives the characters, the terminal would receive its own 
report and try to execute it as a command. Bypass mode 
prevents this from occuring. 

ENTER BYPASS MODE allows you to use Bypass mode in 
other circumstances where you find it useful. 



ENTER VECTOR MODE 

Puts the terminal in Vector mode. 
Host Syntax 



When the terminal is in Vector mode, it interprets ASCII 
characters as xy-coordinates specifying coordinates to 
which a vector is to be drawn or a point to which the graph- 
ics position is to be moved. The cursor moves to the first 
xy-coordinate specified; it draws a vector to subsequent 
points. The G s character has an ADE value of 29. 

To draw rather than move, when specifying the first coordi- 
nate after entering Vector mode, include the b l character 
immediately after the G s character. 

See XY-Coordinates in Host Syntax at the beginning of this 
section for details on how to send those xy-coordinate 
parameters. 



ENTER MARKER MODE 

Puts the terminal in Marker mode. 
Host Syntax 



When the terminal is in Marker mode, it interprets ASCII 
characters as xy-coordinates and draws markers at the 
specified coordinates. (SET MARKER TYPE specifies the 
kind of marker the terminal draws.) The F s character has an 
ADE value of 28. 

See XY-Coordinates in Host Syntax at the beginning of this 
section for details on how to send those xy-coordinate 
parameters. 

The terminal cannot go directly from Marker mode to Vector 
mode; it must first be placed in Alpha mode, then in Vector 
mode. 

The use of Marker mode is explained and illustrated in The 
Graphics Terminal section. 



EXPAND MACRO 

Causes the terminal to expand a macro. 
Host Syntax 



E cKX macro-number 



Setup Syntax 



EXPAND macro-number 



macro-number, integer; indicates the macro to expand. 
Valid ranges are -150 through -2 and through 32767. 
Default: Omitted = 

When a macro is expanded, the terminal looks up the 
macro's definition and responds as if that string was sent 
from the host. See DEFINE MACRO for information on how 
to define a macro's contents. 
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FACTORY 

Temporarily sets ail volatile and nonvolatile parameters to 
factory default values and takes the terminal out of Setup 
mode. 

Setup Syntax 



FACTORY 



To permanently change parameters to factory default, use 

lilts OrtVC l^ulVVULni I ■ I rr-.ri/-uvii_ i i_riO ytv Oz-w i_; win* 

mand after entering FACTORY. 



GRAPHIC TEXT 

Writes a string of graphtext starting at the current graphics 
position. 

Host Syntax 



E cLT text 



Setup Syntax 



GTEXTtext 



text: character array (delimited string in Setup syntax); 
indicates the ASCII characters to be displayed. Each 
character must have an ADE in the range 32 through 126 
( s p through ~). 
Default: Omitted = Empty string 

The terminal displays the text so that the current position is 
aligned with the first character cell. After the text is dis- 
played, the current position is updated to align with the last 
character of the displayed text. The character path deter- 
mines the exact positions. See SET CHARACTER PATH for 
more information. 

If the string is too long to fit in the 4096x4096 terminal 
space, the characters are clipped at the edge of terminal 
space. The current position is set to the edge of terminal 
space where the overflow occurred. 

Graphtext cannot be included in a panel. Therefore, if you 
attempt to use GRAPHIC TEXT between BEGIN PANEL 
BOUNDARY and END PANEL commands, an error results 
and the panel is closed as if END PANEL had been 
executed. 



The Ansi mode command SCS (SELECT CHARACTER 
SET) determines the character set used for graphtext. See 
the Screen Editor Support Section for information on char- 
acter sets. 

These 41 00-style commands affect how graphtext is dis- 
played: SET CHARACTER PATH, SET GRAPHTEXT 
ROTATION, SET GRAPHTEXT SIZE, SET GRAPHICS 
AREA WRITING MODE, SET TEXT INDEX, SET SURFACE 
COLOR MAP, and SET VIEW ATTRIBUTES. 



Causes an attached hardcopy unit to make a copy of the 
terminal's screen or dialog area. 

Host Syntax 



E cKH hardcopy-code 



hardcopy-code: integer; and 1 copy the entire screen, 2 
produces a positive hardcopy image of the entire screen, 3 
copies oniy the dialog area. (To copy only the graphics area, 
make the dialog area invisible and use or 1 .) 
Default: Omitted = 

If you use 0, 1 , or 3, the copy will be a negative image of the 
display (white areas copy black, black areas copy white), 
which is the way a hardcopy normally appears and typically 
is most useful. If you prefer a positive hardcopy image, use 
hardcopy-code 2 in the command. On the keyboard, press- 
ing Ctrl-S Copy makes a negative image copy. 



HELP 

Displays a message that shows the escape sequence, 
Setup name, and parameter types for a command or cluster 
of commands. 



Setup Syntax 



HELP name 



name: string; either a Setup mode command name or the 
name of a cluster of commands for which you want informa- 
tion. The cluster names are COMMUNICATIONS, GIN, 
HARDCOPY, and PIXELS. 
Default: Omitted = All commands 
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Enter this command without a parameter to display all of the 
terminal's commands. In addition to the commands, the 
listing shows the kinds of parameters the commands take. 

You can stop scrolling by pressing Ctrl-S. Press Ctrl-Q to 
continue scrolling. 



IGNORE DELETES 

Determines whether the terminal ignores the d t character. 
Host Syntax 



= cKI ignore-deletes-mode 



Setup Syntax 



IGNOREDEL ignore-deletes-mode 



ignore-deletes-mode: integer (keyword in Setup syntax); or 
no causes the terminal not to ignore d t characters, 1 or yes 
causes the terminal to ignore d t characters. 
Defaults: Factory = (no) 

Power-Up = Saved in memory 

Omitted = 1 (yes) 

See the heading "Coping With d t Filler Characters" in the 
Communications section for further explanation of the use 
of this command. 



LEARN / NVLEARN 

Provides an easy method for programming keys. 



Setup Syntax 



LEARN or NVLEARN 



In Setup mode enter: 

LEARN c r or NVLEARN c r 

This starts a learn function and displays the following 
message: 

Press the key to be defined: 

This key can be any key on the keyboard (except CANCEL, 
CAPS LOCK, CTRL, and SHIFT), including function keys, 
the BREAK key, a shifted space bar, etc. If you press an 
ASCII key, the terminal echoes the ASCII character on the 
screen. If you press a function key or one of the special key- 
codes, such as a shifted return key, the terminal echoes the 
decimal macro number. Then the terminal displays the 
following message: 

Enter definition. (F1 terminates definition, F2 deletes 
last character) 

Now simply type in the ASCII definition; no delimiters are 
necessary. Each ASCII character you enter is added to the 
definition until you press F1 , which ends the definition and 
returns control to Setup mode. Pressing F2 deletes the last 
character entered in the definition. If you press any other 
non-ASCII key during the definition phase, the bell rings 
and the terminal ignores that key-press. 

You can cancel the LEARN definition before ending it (with 
F1) by pressing the CANCEL key. 

If there is not enough memory available to store a macro 
definition when you issue the LEARN command, the termi- 
nal returns control to Setup mode after displaying this 
message: 

Error: Not enough memory available. 

If, however, memory fills up vvMeyou are writing the defini- 
tion, then pressing more ASCII keys will only ring the bell 
and the keys will be ignored. 



Based on which command you enter, LEARN OR 
NVLEARN, a macro or a nonvolatile macro is defined. Other 
than that, the two commands work the same. 
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LFCR 

Specifies whether or not a l f character aiso impiies a c r. 
Host Syntax 



E cKF Ifcr-mode 



Setup Syntax 



LFCR Ifcr-mode 



Ifcr-mode: integer (keyword in Setup syntax); or no means 
that l f does not imply l f c r, 1 or yes means that l f does 
imply l f c r. 
Defaults: Factory = 0(no) 

Power-Up = Saved in memory 

Omitted = 1 (yes) 

The term " l f implies l f c r" means that when the terminal 
receives the l f from the host or you type l f with the terminal 
in Local mode, the terminal displays it as if a h and °r were 
received. However, when you press the Line Feed key, the 
c r character is not sent to the host. 



LOCAL 

Specifies whether terminal is in Local mode. 
Setup Syntax 



LOCAL local-mode 



local-mode: keyword; no takes the terminal out of Local 
mode, yes puts the terminal into Local mode. 



LOCK KEYBOARD 

Disables or enabiesthe keyboard. 
Host Syntax 



E cKL lock-mode 



lock-mode: integer; enables (unlocks) the keyboard), 1 
disables (locks) the keyboard. 
Defaults: Factory = 

Dnuigr I in H 

Omitted = 

Locking the keyboard prevents the operator from entering 
data when important information is being sent from the 
host. 

When the keyboard is locked, all keys except the Cancel 
and Break keys are inoperative. The terminal bell rings 
whenever the operator presses any key except Cancel or 
Break. The operator can unlock the keyboard by pressing 
the Cancel or Break key. 



MACRO STATUS 

Displays the definition of one or all macros. 
Setup Syntax 



MACROSTATUS macro-number 



macro-number, integer in the range -1 50 through 32767 or 
a key specifier; specifies the macro whose definition you 
want displayed. The parameter -1 or the keyword all dis- 
plays all macros. 
Default: Omitted = All 
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This command shows the def intion of the volatile form of a 
macro. This form may or may not match the nonvolatile 
form, depending on whether the macro has been redefined 
since the terminal was powered-up or reset. 

To see the definition of a nonvolatile macro, issue 
MACROSTATUS immediately after you power up or reset 
the terminal. 



MOVE 

Sets the current graphics position without drawing a vector. 
Host Syntax __^_ 



E cLG position 



Setup Syntax 



MOVE position 



position: xy-coordinate; specifies the screen position to set 
the current graphics position to. 
Default: Omitted = (0,0) 

This command does not change the display. It is analogous 
to lifting a pen from the paper in a drawing and moving it to 
a new location. 

The section titled The Graphics Terminal gives examples of 
how to use this command with the DRAW command to 
create lines. 



PAGE 

Erases the screen (except the dialog area). 
Host Syntax 



If the dialog area is enabled, the terminal just erases the 
graphics portion of the screen. 

If the dialog area is not enabled, the terminal erases the 
graphics portion of the screen: 

• Resets the current line style to (solid lines) 

• Terminates 4010 GIN mode 

• Returns the graphics beam to its home position (0,3071) 

• Puts the terminal in Alpha mode 

PIXEL COPY 

(Requires Optional Pixel ROMs) 

Copies pixels from one rectangular region to another. 

Host Syntax 



E cRX destination-surface, 

destination-lower-left-corner, 
first-source-corner, 
second-sou rce-corner 



Setup Syntax 



PXCOPY destination-surface, 

destination-lower-left-corner, 
first-source-corner, 
second-sou rce-corner 



This command has the same effect as pressing the termi- 
nal's G Eras key. 



destination-surface: integer; names the surface to which 
pixels are to be copied. The values -1 , 0, and 1 are valid, 
but since Surface 1 is the terminal's only surface, all valid 
values select Surface 1 . 
Default: Omitted = (Surface 1) 

destination-lower-left-corner: xy-coordinate; specifies the 
lower-left corner of a rectangular region on the destination 
surface in raster memory space. This destination region is 
the same width and height as the source region specified by 
the source corners. The range of values for x is through 
51 1 ; for y, through 359. 
Default: Omitted = (0,0) 
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first-source-corner: xy-coordinate; one corner of a rectangu- 
lar region on the current pixel surface. The PIXEL COPY 
command copies the pixel at this corner to the lower-left 
corner of the destination region. Then it copies each 
remaining pixel in the source region onto a corresponding 
pixel in the destination region. The valid range of values for 
x is through 51 1 ; for y, through 359. 
Default: Omitted = 0,0 

second-source-corner: xy-coordinate; the corner opposite 
the first source corner in the source region. The valid range 
of values for x is through 51 1 ; for u throu n h 359. 
Default: Omitted = 0,0 

The PIXEL COPY command uses the ALU mode specified 
in the most recent BEGIN PIXEL OPERATIONS command. 
Copying pixels to the same location on the pixel writing 
surface can only occur in XOR mode to erase the pixels, or 
in other ALU modes to form mirror images (see following 
"Source Corners" discussion). Using other ALU modes to 
copy (without mirroring) to the same location will do nothing, 
and will not generate an error. 

You can copy pixels using the off-screen raster memory with 
x values from 480 to 511 , but a level warning will be 
generated. 



Source Corners. The two source corners need not be the 
lower-left and upper-right corners of the source region. 
However, if they are not, the pixels written to the destination 



region form a mirror (or inverted) image of the picture 
formed by the pixels in the source region. The pixel at the 
first source corner is copied onto the pixel at the lower-left 
corner of the destination region. The pixel at the second 
source corner is copied onto the pixel at the upper-right 
corner of the destination region. 



PROMPT MODE 

Puts the terminal in Prompt mode or terminates Prompt 
mode. 



Host Syntax 



E cNM prompt-mode 



Setup Syntax 



PROMPTMODE prompt-mode 



prompt-mode: integer (keyword parameter in Setup syntax); 
or no terminates Prompt mode, 1 or yes puts the terminal 
into Prompt mode. 
Defaults: Factory = (no) 

Power-Up = (no) 

Omitted = (yes) 

Prompt mode is explained in the Communications section. 
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RASTER WRITE 

(Requires Optional Pixel ROMs) 

Specifies individually the color indices of a specified num- 
ber of pixels in the current pixel viewport starting at the 
current beam position. 

Host Syntax 



^RP number-of-pixels, 
color-index-codes 



Setup Syntax 



PXRASTERWRITE number-of-pixels, 
color-index-codes 



number-of-pixels: integer; specifies the number of pixels 
represented by the character array that follows this parame- 
ter. Must be in the range through 65535. 
Default: Omitted = Error 

color-index-codes: character array; specifies in a packed 
format the color indices for the pixels specified by number- 
of-pixels. Each code is an ASCII character in the range s p 
through ' (ADE 32 through 96). 
Default: Omitted = 

You can regard the data bits embedded within the code 
characters in the color-index-codes array as a sequential 
string of bits. The bits are grouped to form color indices for 
individual pixels according to the bits-per-pixel parameter in 
the most recent BEGIN PIXEL OPERATIONS command. 
Figures 5-6 and 5-7 show how to pack color indices into the 
color-index-codes parameter. 



If bits-per-pixel is 3, then pack the color indices 0, 0, 2, 3, 2, 7 into a RASTER WRITE command as 
follows: 



1 . " Express the color indices as three-bit binary numerals: 





\ 
000 





I 

000 



2 

\ 
010 



3 

\ 
011 



2 

\ 
010 



7 

I 
111 



2. Group the binary bits into six-bit groups: 

000 000 010 011 



\ 



\ 



010 111 



000000 010011 010111 

3. Add 32 (binary 100000) to these six-bit binary numerals to form seven-bit ASCII characters: 



0100000 


0110011 


0110111 


\ 


1 


\ 


S P 


3 


7 



4. Issue a RASTER WRITE command. The command's first parameter is the integer 6, because the 
command holds six color indices. The second parameter is a character array holding the charac- 
ters s p, 3, and 7. 

RASTER WRITE = E cRP 6 3 s p37 



Figure 5-6. Packing Color Index Codes Using Three Bits Per Pixel. 



5-24 



REV, SEP 1983 



41 05 PROGRAMMERS 



4100 COMMANDS AND REPORTS 
RASTER WRITE 



!f you use 1 for the hits-per-pbcel parameter in the BEGIN 
PIXEL OPERATIONS command, then six color indices 
(each consisting of a single bit) will fit into each code char- 
acter. If bits-per-pixel is 2, then three color indices fit into 
each code character. If bits-per-pixel is 3, then two color 
indices fit into each code character, as shown in Figure 5-6. 

If the bits-per-pixel parameter is set to 4, one-and-a-half 
color indices fit into each code character. That is, every pair 
of codes holds three color indices. Figure 5-7 shows the 



packing scheme. If the bits-per-pixel parameter is 6, the 
terminal interprets each code character as containing only 
one color index, and you can represent each color index in 
the range through 7 with a single ASCII character. 

The special code character ' (ADE 96), functions much like 
a c r l f sequence; it moves the pixel beam position to the 
start of the following row of pixels. The ' code is not included 
in the pixel count. 



If bits-per-pixel is 4, then pack the color indices 0,0,2,3,12,15 into a RASTER WRITE command as 
follows: 

1 . Express the color indices as four-bit binary numerals: 









2 


3 


12 


15 


1 


1 


\ 


1 


1 


1 


0000 


0000 


0010 


0011 


1100 


1111 



2. Group the binary bits into six-bit groups: 

0000 0000 0010 

i ii i 



0011 



1100 



1111 



\ 



000000 



\ 

000010 



001111 



001111 



0100010 


0101111 


0101111 


1 


\ 


\ 


tt 


1 


1 



3. Add 32 (binary 1 00000) to these six-bit binary numerals to form seven-bit ASCII characters: 



0100000 



4. Issue a RASTER WRITE command. The command's first parameter is the integer 6, because the 
command holds six color indices. The second parameter is a character array holding the charac- 
ters s p, ",/, and/. 

RASTER WRITE = E cRP 6 4 s p"// 



Figure 5-7. Packing Color Index Codes Using Four Bits Per Pixel. 
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RECTANGLE FILL 

(Requires Optional Pixel ROMs) 

Sets all the pixels in a rectangle to the specified color. 

Host Syntax 



E cRR lower-left-corner, 
upper-right-comer, 
fill-index 



Setup Syntax 



PXRECTANGLE lower-lett-corner, 
upper-right-corner, 
fill-index 



lower-left-corner: xy-coordinate; specifies one corner of a 
rectangle in raster memory space. The range of values for 
xis0to511;fory,0to359. 
Default: Omitted = (00) 

upper-right-corner: xy-coordinate; specifies the opposite 
corner of that rectangle. The range of values for x is to 
511;fory,0to359. 
Default: Omitted = (00) 

fill-index: integer in the range to 65535; the color index 
with which the rectangle is filled. 
Default: Omitted = (00) 

The color indices are written into raster memory using the 
ALU mode specified in the most recent BEGIN PIXEL 
OPERATIONS command. 

If the lower-left and upper-right corners of the rectangle 
have the same x-value, then the rectangle filled is one-pixel 
wide. Likewise, if the lower-left and upper-right y-values are 
the same, then the rectangle filled is one-pixel high. 

This command also functions in off-screen raster memory 
where the x-value is 480 through 51 1 ; however, a level 
warning will be generated. 



REPORT ERRORS 

Causes the terminal to send an Error Message Report to the 
host. 

Host Syntax 



E cKQ 



This command is intended to be used only by the host. 

When the host sends this command to the terminal, the 
terminal responds by sending to the host the eight most 
recently detected error codes — starting with the most 
recent one. Included in the report are the error codes, their 
severity levels, and how many times each error was 
detected. (Error report severity levels are explained in the 
Error Codes appendix.) 



Error Message Report 

The Error Message Report is a series of up to eight individ- 
ual error messages. The error report message has the fol- 
lowing format: 

error-code-report 

error-code-report 

... (up to eight error-code-reports) 

EOM-indicator 

An example of an actual Error Message Report with two 
individual error messages is: 

KE1121 c rLE0311 c r 

As shown in the Error Codes appendix, the first error mes- 
sage (KE11) means "invalid echo mode"; the numeral 2 
indicates the severity level of the command; the numeral 1 
indicates the number of occurences of this error; the c r is 
the currently defined end-of-message string. The second 
error message consists of LE03, which means "no panel is 
currently being defined"; the 1 is the severity level of that 
command, and the next 1 indicates the number of occur- 
ences of that error; c r is the currently defined end-of- 
message string. 
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The following paragraphs explain each part of the report in 
more detail. 



Error-code-report. The error code report itself is a series of 
ASCII characters, as illustrated in the preceding example. 



EOM-indicator. The EOM-indicator is sent to show between 
each error message in the report and at the end of the 
report to show that it is completed. If there are no errors to 
report, the terminal sends one EOM-indicator. 

REPORT SYNTAX MODE 

Sends a Terminal Settings Report that contains the syntax 
mode status to the host. 



Host Syntax 



E c#!0 



This command has the same effect as a REPORT 
TERMINAL SETTINGS command issued for the SELECT 
CODE command (as if E clQ%! was sent from the host). See 
REPORT TERMINAL SETTINGS. 

This command is recognized in Ansi, Tek, and VT52 modes. 



REPORT TERMINAL SETTINGS 

Reports terminal status for specified setting. 
Host Syntax 



E clQ inquiry-code 



inquiry-code: two characters; indicates the opcode of a 
command or a special two-character inquiry code. 

If you specify a command opcode, the terminal reports the 
current values of the command's settings. Table 5-4 
describes the report you receive if you specify a special 



inquiry code. The opcode is the two characters that follow E c 
in the Host syntax form of a command. The terminal 
responds to the REPORT TERMINAL SETTINGS by send- 
ing the status of the specified command to the host. For 
example, the following command inquires about the status 
of Prompt mode: 

E clQNM 

The terminal sends the Prompt mode status (that is, 
whether or not the terminal is in Prompt mode) to the host. 
More detail is included later in this explanation under the 
heading "Examples." 

A special inquiry code instead of an opcode can be used to 
request information concerning the amount of terminal 
memory remaining, the terminal model number, and the 
firmware version installed in the terminal. Table 5-4 shows 
the inquiry code used in each case and the format of the 
reports returned. 



Table 5-4 
SPECIAL INQUIRY CODES AND REPORTS 



Inquiry 
Code 


Format of Report 


Explanation 


?M 


total-available-memory, 
largest-block-available 


Two encoded integers 
showing the total and 
largest blocks of memory 
available 


?T 


terminal-model-number 


An integer showing the 
terminal model number, 
for example 4105 


00 


standard-firmware 
version-number 


An integer showing the 
version number of the 
firmware currently 
installed 



The following command would be used to request informa- 
tion about the amount of terminal memory remaining (more 
detail is provided later under the heading "Examples"): 

E c IQ?M 
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The Terminal Settings Report 

The terminal sends the terminal settings report in response 
to REPORT TERMINAL SETTINGS. It consists of the 
opcode report, the parameter report, and the EOM- 
indicator, in the following format: 

inquiry-code 

parameter-report 

EOM-indicator 

When you use a special inquiry code instead of an opcode, 
the report has the following format: 

special-inquiry-code 
special-i nq u i ry-report 
EOM-indicator 



Inquiry-code or special-inquiry-code. This part of the 
report consists of two ASCII characters, which are: 

• The same as the opcode specified in the corresponding 
REPORT TERMINAL SETTINGS command. 

• The same as the special inquiry code specified in the 
corresponding REPORT TERMINAL SETTINGS command. 

• Two H characters if the specified opcodeor special 
inquiry code does not exist. 



Parameter-report or special-inquiry-report. This consists 
of one or more alphanumeric characters, depending on the 
particular parameter or special inquiry. See "Examples." 



EOM-indicator. The EOM-indicator is sent to show that the 
message is complete. 

The only exceptions to this format are the reports for SET 
SURFACE COLOR MAP and SET DIALOG AREA COLOR 
MAP. See the discussion following "Examples." 



Examples 

The following REPORT TERMINAL SETTINGS command 
requests information for parameters set by the command 
with the opcode NR (SET BAUD RATE): 

E clQNR 

The following report indicates that the terminal has a trans- 
mit and receive baud rate of 1200: 

NR! + 0! + c r 

Similarly, the following command asks how much memory is 
available: 

E clQ?M 

The following report indicates that the total amount of 
available memory is 600 and the largest block available is 
300 (a block has 1 6 bytes). 

?ME8 2< c r 



The SET DIALOG AREA COLOR MAP Report 

This report has the following format: 

TF 

color-info 
EOM-indicator 

The TF is the opcode for SET DIALOG AREA COLOR MAP. 

The color-info consists of a series integers indicating the 
color mixtures for each color index. Each color is identified 
by a triplet. Each triplet reports the hue, lightness, and 
saturation for a color index. Eight triplets are sent; one for 
each color index. The last character in the report is the 
current EOM-indicator, which is sent to show that the report 
is over. 
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The SET SURFACE COLOR MAP Report 

This report has the following format: 

TG 

1 

color-info 

EOM-indicator 

The TG is the opcode for SET SURFACE COLOR MAP. 

The integer 1 indicates that one graphics surface is defined 

/ac ic alu/auc th*s cace fnr this torminflh 

The color-info consists of a series of integers indicating the 
color mixtures for each color index. The first integer indi- 
cates that 25 integer reports follow — a triplet for the back- 
ground index, followed by the surface number indicator, 
followed by seven more triplets. Each triplet consists of 
three integer reports that specify the hue, lightness, and 
saturation for a color index. One triplet is sent for each of 
the eight indices. The last character in the report is the 
current EOM-indicator, which is sent to show that the report 
is over. 



REPORT 4010 STATUS 

Causes the terminal to emulate a 4010-style terminal by 
sending a 401 status report. 

Host Syntax 



If the terminal is not in GIN mode, the report has the follow- 
ing format: 

terminai-status 

alpha-cursor-position 

EOM-indicator 

If the terminal is in GIN mode, the report has the following 
format: 

graphics-cursor-position 
EOM-indicator 

The following paragraphs detail the parts of the report. 



Terminal-status. The status of the terminal is encoded into 
the seven bits of an ASCII character, as follows: 



b7 


b6 


b5 


b4 


b3 


b2 


b1 





1 


HCU 


NOLI 


GRAPH 





1 



Bits 7 and 6 are always set to and 1 , respectively; Bits 2 
and 1 are also set to and 1 , respectively. 

The HCU (Bit 5) is set to if a hardcopy unit is attached to 
the terminal and is ready to accept a copy request; other- 
wise this bit is set to 1 . 

Bits 4 and 5 indicate the No Linear Interpolation (NOLI) and 
Graph mode status as follows: 



This command also terminates 4010 GIN mode and returns 
the terminal to Alpha mode. 



NOLI 


GRAPH 








The terminal is in Marker mode 





1 


The terminal is in Alpha mode 


1 





The terminal is in Vector mode 


1 


1 


This combination does not occur 



4010 Status Report 

This report is sent in response to REPORT 4010 STATUS. 
The report has two forms, depending on whether the termi- 
nal is in GIN mode when the command is sent. 



For example, if the terminal (1 ) has a hardcopy unit 
attached, (2) is ready for a hardcopy command, and (3) is in 
Vector mode, the bits sent are: 

0101001 

The corresponding character on the ASCII chart is the clos- 
ing parenthesis — ) — which would be transmitted as the 
status byte. 
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Alpha-cursor-position and graphics-cursor-position. The 

terminal reports both cursor positions in the following 
format: 

Hi-X 
Lo-X 
Hi-Y 
Lo-Y 

The Hi-X, Lo-X, Hi-Y, and Lo-Y characters follow the same 
general coding method described under the heading XY- 
Coordinates in Host Syntax earlier in this section, with two 
important differences: 

• The first two bits of each charater are set to 01 . 

• Only the ten most significant bits are included in the 
report. 

Figure 5-8 illustrates the binary process of decoding the 
ASCII characters that report that the cursor is at 
(1000,2000). To report these coordinates the terminal sends 
the following characters: 

':/4 



The host program must convert each character to equiva- 
lent numbers (ASCII Decimal Equivalents). Figure 5-8 
shows the binary representation of these numbers. The first 
two bits are always 01 , confirming that these are report 
characters. To get rid of the 01 prefix, subtract decimal 32 
from each number (Hi-X = 39-32 = 7). The remaining val- 
ues combine to form the two decimal xy-coordinates: 

• Multiply the Hi-X value by decimal 1 28 and save the 
product: (7* 128 = 896) 

• Multiply the Lo-X value by decimal 4 and save the prod- 
uct: (26* 4 = 104) 

• Add the two products, yielding the x coordinate: (896 + 
104 = 1000) 

• Repeat the previous three steps with the y-values to find 
they-coordinate. 

Notice that the last two bits of the cursor position are not 
reported and can be assumed to be (00). 



EOM-indicator. The EOM (End Of Message) character may 
be sent to show that the 4010 Status Report message is 
complete. However, it is not an essential part of the 
message. 





Cursor Report 


= ':/4 

ASCII 
Character 




ADE 


Hi-X 01 00111 


= 


f 




39 


Lo-X 01 11010 


= 






58 


Hi-Y 01 01 111 


= 


1 




47 


Lo-Y 01 10100 


= 


4 




52 


X-Coordinate = decimal 1000 






Y-Coordinate 


= decimal 2000 


= binary 00111 11010 00 






= binary 


01111 10100 00 


■ — . — ■ — . — • — . — • 








■ — . — • ■ — . — • — . — ■ 


Hi-X Lo-X Not 








Hi-Y Lo-Y Not 


Used 








Used 

4526-41 



Figure 5-8. The Cursor Position Report. 
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RUNLENGTH WRITE 
(Requires Optional Pixel ROMs) 

Loads color indices into the pixel viewport. 

Host Syntax 



E cRL runcode-array 



Setup Syntax 



PXRUNLENGTHWRITE runcode-array 



runcode-array: integer-array; specifies a color index and the 
number of pixels which are to be set to that color index. Can 
range from to 65535. 
Default: Omitted = Empty Array 

Each runcode includes two numbers packed together: 
The runcodes are packed using the form 

Runcode = number-of-pixels*2" + color-index 

where n = number-of-bits-per-pixel 

The bits-per-pixel parameter from the most recent BEGIN 
PIXEL OPERATIONS command supplies the value for n 
unless that parameter is 6 or 4; then the value of n is 3. 

Starting at the current pixel beam position in the pixel view- 
port, the terminal sets the specified number of pixels to the 
specified color index for each runcode in the array. As each 
pixel is assigned a color index, the pixel beam position 
moves so that it points at the next pixel to the right on the 
same line. On encountering the right edge of the pixel view- 
port, the pixel beam position wraps around to point to the 
pixel at the left edge of the pixel viewport on the line below; 
however, if the pixel beam position is on the bottom line, the 
beam position wraps around to the left edge of the top line 
of the pixel viewport. When all the pixels for a given runcode 
have been loaded with the specified color index, the proc- 
ess is repeated for the next runcode in the integer array. 



SAVE NONVOLATILE PARAMETERS 

Saves nonvolatile parameters that have been altered. 
Host Syntax 



E cKU 



Setup Syntax 



NVSAVE 



This command causes the terminal to write to its nonvolatile 
memory all parameters that have been changed since the 
last SAVE NONVOLATILE PARAMETERS. The values of 
those parameters are restored at power-up and are referred 
to in this manual as the Power-Up Defaults. 

Nonvolatile memory means memory that is retained after 
the terminal is turned off. Parameters that are saved in 
nonvolatile memory are referred to in this manual as saved 
in memory. 

The appendix titled Parameter Default Values lists all 
parameters that are saved in memory. 

This command writes only parameters that have changed 
since the last time this command was issued. 

Each byte of nonvolatile memory has a lifetime of about 
10,000 writes. If you attempt to write to nonvolatile memory 
after that, the terminal may display an error message 
(depending on the SET ERROR THRESHOLD LEVEL 
setting that states that there is a "nonvolatile hardware 
error." When that occurs, parameters are reset to factory 
default the next time the terminal is powered up. 
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SELECT CODE 

Causes the terminal to recognize Ansi, Tek, or VT52 mode 
command syntax. Also used to select Edit mode. 

Host Syntax 



E c%! syntax 



Setup Syntax 



CODE syntax 



syntax: integer (keyword in Setup syntax); selects Tek 

mode syntax. 1 selects Ansi mode syntax for Ansi mode, 

2 selects Ansi mode syntax for Edit mode, 3 selects VT52 

mode syntax. In Setup mode, enter TEK, ANSI, EDIT, or 

VT52. 

Default: Omitted = (Tek mode) 

The syntax of Tek, Ansi, and VT52 mode commands are not 
compatible. If you are using commands from one mode and 
want to execute one or more commands from another 
mode, you must issue the SELECT CODE command with 
the appropriate parameter. 

This command is recognized in all major modes: Ansi, 
Setup, Tek, and VT52. 



SELECT FILL PATTERN 

Specifies the fill pattern for subsequent panels. 
Host Syntax 



E cMP fill-pattern-number 



Setup Syntax 



FILLPATTERN fill-pattern-number 



fill-pattern-number, integer; must be in the range -7 
through 174: 

• -7 through cause a panel to be filled with a solid 
color indicated by the negative value of a color index 
(for example, -3 means fill with color index 3's color) 

• 1 through 1 6 specify predefined patterns 

• 17 through 49 are invalid and generate an error 

• 50 through 1 74 specify predefined dither patterns 
Defaults: Factory = -1 

Power-Up = -1 
Omitted = 

For example, here's how you would select Fill Pattern 16 
(encoded as A0) in Host syntax. 

E cMPA0 



SELECT HARDCOPY INTERFACE 

Selects the copier type to be used in the HARDCOPY 
command. 



Host Syntax 



E cQD copier type 



Setup Syntax 



HCINTERFACE copier-type 



copier-type: integer; selects a monochrome copier, 1 and 
2 select the TEKTRONIX 4695 Color Copier. The mono- 
chrome selection is for compatibility with black-and-white 
printers. Selecting a monochrome copy type allows only 
regular-sized dialog copies. 
Defaults: Factory = 2 

Power-Up = Saved in memory 

Omitted = 



5-32 



REV, SEP 1983 



4105 PROGRAMMERS 



4100 COMMANDS AND REPORTS 
SET BAUD RATES 



SET ALPHA CURSOR INDEX 

Assigns specified color indices to the alpha cursor. 
Host Syntax 



E cTD first-index, 
second-index 



Setup Syntax 



ACURSOR first-index, 

second-index 



SET ALPHA TEXT FONT 

Selects font to be used for alphatext. 
Host Syntax 



E c font-code 



font-code: small integer; the s i character selects the GO 
character set, s o selects the G1 character set. Regardless 
of alphatext font selected, in Setup mode, the terminal uses 
the ASCii font. 
Default: Power-Up = GO character set 



first-index: integer; specifies the first color for the alpha 
cursor. Must be in the range to 65535. The values 
through 7 correspond to a color index (values greater than 7 
set first-index to 7). 
Defaults: Factory = 1 

Power-Up = Saved in memory 

Omitted = 

second-index: integer; specifies the second color for the 
alpha cursor. Must be in the range to 65535. The values 
to 7 correspond to a color index (values greater than 7 set 
second-index to 7). 
Defaults: Factory = 

Power-Up = Saved in memory 

Omitted = 

The alpha cursor appears on the screen where the next 
alphanumeric character will be displayed. \i second-index is 
a different color than first-index, the cursor blinks between 
the two colors. If the two indices are the same, the cursor 
does not blink. 

The dialog area and the graphics area each have their own 
set of color indices. When the dialog area is enabled, the 
alpha cursor indices refer to dialog area indices. When the 
dialog area is disabled, the alpha cursor indices refer to 
graphics area indices. 



SET BAUD RATES 

Sets the terminal's transmit and receive baud rates (in bits 
per second). 

Host Syntax 



E cNR transmit-data-rate, 
receive-data-rate 



Setup Syntax 



BAUDRATE transmit-data-rate, 
receive-data-rate 



transmit-data-rate: integer; the baud rate at which the termi- 
nal sends data to the host. Valid values are 1 (which means 
"external clock"), 75, 1 10, 134, 150, 300, 600, 1200, 1800, 
2000, 2400, 4800, 9600, 19200, and 38400. 
Defaults: Factory = 2400 

Power-Up = Saved in memory 

Omitted = Error 

receive-data-rate: integer; the baud rate at which the termi- 
nal expects to receive data from the host. Valid values are 
the same as for the transmit-data-rate with the addition of 0, 
which means "same as the transmit rate." 
Defaults: Factory = 2400 

Power-Up = Saved in memory 
Omitted = Same value as transmit- 
baud-rate parameter 

If you set the baud rate to 38400, the transmit and receive 
parameters must be the same. 
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SET BREAK TIME 

Sets the duration (in milliseconds) of the break signal the 
terminal sends when you press the Break key. 

Host Syntax 



E cNK break-time 



Setup Syntax 



BREAKTIME break-time 



breaktime: integer; indicates the length of the break signal 
in milliseconds. Must be in the range through 65535. A 
value of causes no break signal to be sent. 
Defaults: Factory = 200 

Power-Up = Saved in memory 

Omitted = 



SET BYPASS CANCEL CHARACTER 

Specifies the character that cancels Bypass mode. 
Host Syntax 



E cNU bypass-cancel-character 



Setup Syntax 



BYPASSCANCEL bypass-cancel-character 



bypass-cancel-character, small integer; indicates the ADE 
value of the character that cancels Bypass mode. In Setup 
syntax, you can specify an ADE value or enter the corres- 
ponding ASCII character. 
Defaults: Factory =10( l f) 

Power-Up = Saved in memory 

Omitted = ( N u ) 

The bypass-cancel character should be the same as the last 
character that the host sends as it echoes a line of text to 
the terminal. 



In Setup mode, to specify an ADE value in the range 
through 9, precede the digit with 0. For example, indicate 
h t (ADE 9) as 09. The single digits through 9 indicate the 
digit characters (ADE 48 through ADE 57). 

If the bypass-cancel character is set to N u the terminal does 
not enter Bypass mode when reports are sent. 

See the Communications section for an explanation of the 
terminal's Bypass mode. 



SET CHARACTER PATH 

Specifies the direction to move after writing each graphtext 
character. 



Host Syntax 



E cMN direction 



Setup Syntax 



GTPATH direction 



direction: integer (keyword in Setup syntax); indicates 
which direction graphtext characters are written. Table 5-5 
defines each value's effect. 
Default: Factory = (right) 

Power-Up = (right) 

Omitted = (right) 

Table 5-5 
CHARACTER PATH SETTINGS 



Integer 


Setup 
Keyword 


Meaning 





right 


Use path equal to rotation angle 


1 


left 


Use path 180° greater than rotation angle 


2 


up 


Use path 90° greater than rotation angle 


3 


down 


Use path 90° less than rotation angle 
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Figure 5-9 shows how the string "ABC" is displayed using 
the four different directions for character path. Note that 
graphtext rotation is 0° for ail examples in Figure 5-9. 



The keywords (right, up, left, and down) refer to character 
path after orientation with the rotation angie specified in 
SET GRAPHTEXT ROTATION. Table 5-5 gives explicit 
definitions of the keywords. 



Integer 
Setting 




Setup 
Parameter 


Example 


Path Relation 
to Rotation Angle 









RIGHT 


xABC^ 


Same 


1 




LEFT 


*CBA X 


+ 180° 


2 




UP 


* 

C 


+ 90° 








B 












A 

X 






3 




DOWN 


X 

A 


-90° 








B 












C 

* 






Note: Graphtext 


is "ABC" with rotation =0° in all 


examples. 


xis 


graphics position before graphtext is displayed. 




* is updated graphics position after graphtext 


is displayed. 














4526-1 7B 



Figure 5-9. Character Path Settings. 
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SET COPY SIZE 

Sets the copy size. 
Host Syntax 



E cQA size 



Setup Syntax 



HCSIZE size 



size: integer; selects the default copy size (8 1 /2x11), 1 
selects a smaller copy size. 
Defaults: Factory = 

Power-Up = 

Omitted = 

The smaller size produces a faster copy, but only in eight 
colors: black, white, red, green, blue, cyan, magenta, and 
yellow. 



This command takes effect as soon as it is given. The dialog 
area buffer is changed to the size specified, with the amount 
of free memory determining the maximum number of lines 
allowed in the buffer. If number-of-lines is greater than the 
amount of memory available, the terminal modifies the 
parameter amount to agree with the available memory. For 
a more detailed description of the dialog area, see The 
Graphics Terminal section of this manual. 

If you set the dialog buffer size to less than the size of the 
dialog area, the size of the dialog area is automatically 
changed to match the size of the dialog buffer. 

The Ansi mode commands TEKOM and TEKSTBM can set 
a nonscrolling dialog area. When this is the case, if you 
specify a dialog buffer larger than the screen size (30 lines), 
the top and bottom margins are reset to Lines 1 and 30. If 
Origin mode is Absolute and you specify a dialog buffer 
larger than the screen size, the Origin mode is set to 
Relative. 



SET DIALOG AREA COLOR MAP 



The smaller copy size also allows you to copy 1 32 columns 
on the same line. If, however, the default copy size is 
chosen and Column mode is set to 1 32, the extra 52 
columns are wrapped to the next line. 

If you are using a monochrome copier, selecting the smaller 
copy size does not produce a smaller copy. 



SET DIALOG AREA BUFFER SIZE 

Specifies the maximum number lines of text stored in the 
dialog area buffer. 



Host Syntax 



E cLB number-of-lines 



Setup Syntax 



DABUFFER number-of-lines 



Specifies the color assigned to one or more color indices in 
the dialog area. 

Host Syntax 



E cTF color-mixture . 



Setup Syntax 



DACMAP color-mixture . 



color-mixture: integer array; consists of groups of four inte- 
gers (quadruples). Each quadruple specifies a color index 
(valid range through 7) and the HLS coordinates of the 
color being assigned to that index: hue (a valid range of 
-32768 through 32767), lightness (a valid range of through 
100), and saturation (a valid range of through 100). 
Defaults: Factory = See Table 5-6 

Power-Up = Saved in memory 
Omitted = No change to color map 



number-of-lines: integer; indicates the maximum number 

lines in the dialog buffer. Must be in the range 2 through 

32767. 

Defaults: Factory = 49 

Power-Up = Saved in memory 

Omitted = Error 
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Table 5-6 
FACTORY DEFAULT COLOR INDICES 



Color 


Color Mixture 


Color Coordinates 9 


Index 


H 


L 


S 





Black 











1 


White 





100 





2 


Red 


120 


50 


100 


3 


Green 


240 


50 


100 


4 


Blue 





50 


100 


5 


Cyan 


300 


50 


100 


6 


Magenta 


60 


50 


100 


7 


Yellow 


180 


50 


100 



H = hue, L = lightness, S = saturation 

When specifying a color in most commands, you use a color 
index, which is an integer in the range through 7. SET 
DIALOG AREA COLOR MAP defines the color for one or 
more dialog area color indices. The graphics area has its 
own set of color indices, which is defined with the SET 
GRAPHICS AREA COLOR MAP. 

The color assigned to Index applies only to alphatext 
characters. For the dialog area background and character 
backgrounds, Index always means "transparent." The 
concept of transparency is explained in The Graphics 
Terminal section. 

For example, the following command in Host syntax speci- 
fies white (HLS coordinates 0, 1 00, 0) for Index 3 in the 
dialog area: 

E cTF430F40 

The first 4 indicates that four values follow. 



In Setup syntax, this command is: 
DACMAP3 0100 

See The Graphics Terminal section and the Tektronix Color 
Standard appendix for more details of how the terminal 
displays colors. 



SET DIALOG AREA INDEX 

Specifies the color index for alphatext characters, charac- 
ter-cell background, and dialog area background. 



Host Syntax 



E cLI character-index, 

character-background-index, 
dialog-background-index 



Setup Syntax 



DAINDEX character-index, 

character-background-index, 
dialog-background-index 



character-index: integer; indicates the color index of the 
characters displayed in the dialog area. Must be in the 
range through 65535. 
Defaults: Factory = 1 

Power-Up = Saved in memory 

Omitted = 
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character-background-index: integer; indicates the color 
index used for each character-cell background. Must be in 
the range through 65535. Index indicates transparency. 
Defaults: Factory = 

Power-Up = Saved in memory 

Omitted = 



This command does not affect lines in the dialog area that 
have already been displayed. Future lines are displayed 
with the new indices. 



SET DIALOG AREA LINES 



dialog-background-index: integer; indicates the color index 
of the dialog area background. Must be in the range 
through 65535. This is the color of the dialog area before 
characters are written on it and after it is erased. Index 
indicates transparency. 
Defaults: Factory = 

Power-Up = Saved in memory 

Omitted = 

Color Indices through 7 represent colors identified by the 
dialog area's color indices. These colors are defined by SET 
DIALOG AREA COLOR MAP. The dialog area has its own 
indices separate from those used for graphics. When you 
specify a value greater than 7 for any color index, the termi- 
nal uses Index 7. 

When the terminal displays a character in the dialog area, it 
also displays the character cell that encloses the character. 
The cell is displayed in the character background color. The 
color of a character cell is set by character-background- 
index. 

When Index is used as the character-index, it represents 
an opaque color just like Indices 1 through 7. However, 
when Index is used as the character-background-index ox 
the dialog-background-index, it means "make this area 
transparent." Graphics behind the dialog area show 
through a transparent area; if the character background is 
transparent, the dialog appears as if it were written on a 
piece of glass in front of the graphics. 



Specifies the maximum number of lines visible in the dialog 
area. 

Host Syntax 



E cLL number-of-lines 



Setup Syntax 



DALINES number-of-lines 



number-of-lines: integer; sets the maximum size in lines for 
the dialog area. Must be in the range 2 through 30. 
Defaults Factory = 30 

Power-Up = Saved in memory 

Omitted = Error 

To be visible, the dialog area must be both enabled and 
visible. A host program enables the dialog area with 
ENABLE DIALOG AREA; the operator issues the Setup 
command DAENABLE. A host program sets visibility with 
SET DIALOG VISIBILITY; the operator uses DAVISIBILITY. 

If you set the number of dialog area lines to be greater than 
the size of the dialog buffer, the size of the dialog buffer is 
changed to be the same size as the dialog area. 
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SET DIALOG AREA VISIBILITY 

Specifies whether the dialog area is visible or invisible. 
Host Syntax 



E cLV visibility-mode 



Setup Syntax 



DAVISIBILITY visibility-mode 



visibility-mode: integer (keyword in Setup syntax); or no 
makes the dialog area invisible, 1 or yes makes the dialog 
area visible. 
Defaults: Factory = 1 (yes) 

Power-Up = Saved in memory 

Omitted = 1 (yes) 

This command serves the same purpose as the Dialog key 
— it sets the dialog area to be is visible or invisible. 

If ENABLE DIALOG AREA is set to send alphatext to the 
dialog buffer and the dialog area is enabled but not visible, 
alphatext is saved in the dialog buffer. Then, when SET 
DIALOG VISIBILITY is given with 1 ox yes (making the dialog 
area visible), the alphatext in the dialog area becomes visi- 
ble. The terminal will automatically scroll the dialog area, if 
necessary, to put the cursor in view. 



SET DIALOG AREA WRITING MODE 

Specifies whether the s p (Space) and _ (Underscore) char- 
acters overstrike or replace other characters in the dialog 
area. 



Host Syntax 



E cLM writing-mode 



writing-mode: integer (keyword in Setup syntax); or 

replace specifies replace, 1 or overstrike specifies 

overstrike. 

Defaults: Factory = (replace) 

Power-Up = Saved in memory 

Omitted = (replace) 

This command affects only how the space and underscore 
characters are displayed in the dialog area. If the dialog 
area is set to overstrike, you can underline alphanumeric 
characters. 

Alphatext displayed in the graphics area is not affected by 
this command. (Alphatext is displayed in the graphics area 
when the dialog area is disabled.) SET GRAPHICS AREA 
WRITING MODE sets overstrike capability for graphics area 
alphatext. 



SET DIALOG HARDCOPY ATTRIBUTES 

Specifies the number of pages to be copied, the starting 
page, and how formfeed is interpreted. 



Host Syntax 



E cQL number-of-pages, 



page-origin, 
^-interpretation 



Setup Syntax 



HCDAATTRIBUTES number-of-pages, 
page-origin, 
^-interpretation 



number-of-pages: integer; determines the number of pages 
to be copied from the origin to the bottom of the dialog 
buffer. Must be in the range of to 32767. 
Defaults: Factory = 1 

Power-Up = 1 

Omitted = 1 



Setup Syntax 



DAMODE writing-mode 



page-origin: integer; determines the starting page for the 
copy. specifies the first visible line in the scroll, 1 the top of 
the scroll, and 2 the bottom of the scroll. 
Defaults: Factory = 

Power-Up = 

Omitted = 
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F F-interpretation: integer; determines how the terminal inter- 
prets ASCII formfeed in the dialog buffer. If ^-interpretation 
is 0, then terminal ignores f f and divides the dialog buffer 
into pages containing 66 lines (60 lines of text and 3 blank 
lines at the top and bottom); if F F-interpretation is 1 , the ter- 
minal starts a new page every 66 lines or when f f appears 
in the text; if F F-interpretation is 2, the terminal starts a new 
page only when f f appears in the text. 
Defaults: Factory = 

Power-Up = 

Omitted = 

If the origin is set to the bottom of the dialog buffer, the copy 
begins that many pages up from the bottom of the dialog 
buffer. If number-of-pages is 0, then there is no change from 
the last setting. If you specify a greater number of pages 
than the dialog buffer contains, only the contents of the 
dialog buffer are copied. 

For pages that have lines longer than 80 characters, the 
extra characters are sent without an intervening c r. This 
allows printers with widths greater than 80 columns to be 
used. The TEKTRONIX 4695 Color Copier automatically 
generates a c r l f and starts printing on the next line for lines 
containing more than 80 characters. If the SET COPY SIZE 
command has been executed with a parameter of 1 (to set 
the small copy size), then the 1 32 characters are printed on 
the same line. 

When using this command, you need to be aware of how 
number-of-pages and ^-interpretation interact with each 
other. The amount of text that goes on each page can vary 
depending on how the terminal divides the dialog buffer into 
pages, and that depends on the setting of F F-interpretation. If 
you issue this command with its default parameters, it 
copies 60 lines of text, beginning with the first visible line on 
the screen. If, however, you set number-of-pages to 4, f f- 
interpretation to 2, and have four f f's beginning the text on 
the screen , then the copier turns out four blank sheets of 
paper. Additionally, if number-of-pages is 1 , page-origin is 1 , 
F F-interpretation is 2, and there are no f f's in the text, then 
the copier prints the entire dialog buffer with no page breaks 
(on the TEKTRONIX 4695 copier, this would be a continu- 
ous sheet of paper). 

You can stop a hardcopy operation by pressing the 
Cancel key. 



SET ECHO 

Specifies whether the terminal echoes characters it trans- 
mits to the host. 

Host Syntax 



E cKE echo-mode 



Setup Syntax 



ECHO echo-mode 



echo-mode: integer (keyword in Setup syntax); or no 
causes the terminal not to provide the echo, 1 or yes causes 
the terminal to provide the echo. 
Defaults: Factory = (no) 

Power-Up = Saved in memory 

Omitted = 1 (yes) 



SET EDIT CHARS 

Specifies the terminal's special editing characters used in 
Setup mode. 



Host Syntax 



E cKZ character-delete, 
line-delete, 
literal 



Setup Syntax 



EDITCHARS character-delete, 
line-delete, 
literal 



character-delete: integer (small integer in Setup syntax); 
specifies the key used in Setup mode to erase the character 
just left of the cursor. 
Defaults: Factory = 127 ( d t) 

Power-Up = Saved in memory 

Omitted = Unchanged 
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line-delete: integer (small integer in Setup syntax); specifies 
the key used in Setup mode to erase the current line. 
Defauits: Factory =24 ( c n ) 

Power-Up = Saved in memory 

Omitted = Unchanged 

literal: integer (small integer in Setup syntax); specifies the 
character used just before an editing character to suspend 
its control action and print it as text. Only the character 
immediately following the literal character is affected. Use 
the literal character before c r and the three special editing 
characters defined in this command. 

n.b.iiUfi< p««+«,w _ hoc/ \ 

wciauuS. rautui y = itopj 

Power-Up = Saved in memory 
Omitted = Unchanged 



In Setup syntax, precede ADEs less than ten with a 0. For 
example, 08 indicateds ADE 8, the Back Space character. 
The single digit 8 indicates the character 8, whose ADE is 
56. Refer to the ASCII Code Chart appendix. 



SET EOF STRING 

Specifies the terminal's end-of-file string. 
Host Syntax 



E cNE eof-string 



Setup Syntax 



EOFSTRING eof-string 



eof-string: integer array (delimited string in Setup syntax); 
specifies end-of-file string sent by the host. Maximum 
length is ten characters. In Host syntax, each element of the 
integer array indicates a character's ADE value and must be 
a small integer (0 through 1 27). In Setup syntax, the ADE of 
each character in the string must be in this same range. 
Defaults: Factory = Empty array 

Power-Up = Saved in memory 

Omitted = Empty array 

After the host transmits all data in a COPY command, it 
sends the EOF string to terminate the command. 



SET EOL STRING 

Specifies the terminal's end-of-line string. 
Host Syntax 



E cNT eol-string 



Setup Syntax 



EOLSTRING eol-string 



eol-string: integer array (delimited string in Setup syntax); 
specifies the end-of-line string sent in reports to host. Maxi- 
mum length is two characters. In Host syntax, each element 
of the integer array indicates a character's ADE value and 
must be a small integer (0 through 1 27). In Setup syntax, 
the ADE of each character in the string must be in this same 
range. 
Defaults: Factory =13( c r) 

Power-Up = Saved in memory 

Omitted = Empty array 

This command sets the string that terminates each line of 
reports the terminal sends to the host. Typically this string is 
a c r (ADE 1 3). This command lets you change the end-of- 
line string. 

SET EOM CHARACTERS 

Specifies the character(s) used to terminate messages. 
Host Syntax 



E cNC first-EOM-indicator, 

second-EOM-indicator 



Setup Syntax 



EOMCHARS first-EOM-indicator, 

second-EOM-indicator 
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first-EOM-indicator. small integer; indicates ADE of first 
end-of-message character. In Setup mode, you can just 
enter the character. 
Defaults: Factory = 13 ( c r) 

Power-Up = Saved in memory 

Omitted = ( N u ) 

second-EOM-indicator. small integer; indicates ADE of 
second end-of-message character. In Setup mode, you can 
just enter the character. 
Defaults: Factory = ( N u ) 

Power-Up = Saved in memory 

Omitted = ( N u ) 



SET ERROR THRESHOLD 

Specifies the kinds of error messages the terminal displays. 
Host Syntax 



E cKT error-threshold-level 



Setup Syntax 



ERRORLEVEL error-threshold-level 



error-threshold-level: integer; indicates minimum error level 
displayed. Must be in the range of to 4: 

All messages, warnings, errors, and terminal failure 
messages are displayed 

1 Warnings, errors, and terminal failure are displayed 

2 Errors and terminal failure messages are displayed 

3 Terminal failure messages are displayed 

4 No messages, warnings, errors, or terminal failure 
messages are displayed 

Defaults: Factory = 2 
Power-Up = 2 
Omitted = 

This command only determines the level of error messages 
that are displayed on the screen. The terminal records the 
eight most recent error messages and transmits them in 
response to REPORT ERRORS whether or not the error 
message was displayed on the screen. 



SET FLAGGING MODE 

Specifies the kind of flagging the terminal uses. 
Host Syntax 



E cNF flagging-mode 



Setup Syntax 



FLAGGING flagging-mode 



flagging-mode: integer (keyword in Setup syntax); or none 
means no flagging; 1 or input means the terminal uses 
D i / D 3 flagging when receiving from the host; 2 or output 
means the terminal uses D i/ D 3 flagging when transmitting 
to the host; 3 or in/out means the terminal uses °i / D 3 
flagging both when transmitting and receiving; 4 or DTR/ 
CTS means that the DTR (Data Terminal Ready) and CTS 
(Clear To Send) signal lines at the RS-232 connector regu- 
late the flow of data. 
Defaults: Factory = (none) 

Power-Up = Saved in memory 

Omitted =0(none) 



SET GIN CURSOR COLOR 

Specifies the color of the terminal's Graphics Input (GIN) 
cursor. 



Host Syntax 



E cTC hue, 

lightness, 
saturation 



Setup Syntax 



GCURSOR hue, 

lightness, 
saturation 



hue: integer; specifies hue. Must be in the range -32767 to 
32767. The terminal automatically converts this integer to 
an equivalent number of degrees in the range through 359. 
Defaults: Factory = 

Power-Up = Saved in memory 

Omitted = 
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lightness: integer; indicates lightness. Must be in the range 

to 100. 

Defaults: Factory = 100 

Power-Up = Saved in memory 

Omitted = 

saturation: integer; indicates saturation. Must be in the 
range to 100. 
Defaults: Factory = 

Power-Up = Saved in memory 

Omitted = 

The color of the GIN cursor is independent of the eight 
graphics area and eight dialog area colors. 

See The Graphics Terminal section for a discussion of color. 
The operators manual discusses use of the color interface. 

SET GIN CURSOR SPEED 

Determines the speed at which the GIN cursor moves 
across the screen when the joydisk is pressed. 

Host Syntax 



E cU normal-speed, 
shifted speed 



Setup Syntax 



GSPEED normal-speed, 
shifted speed 



normal-speed: integer; determines the speed at which the 
gin cursor moves across the screen when the joydisk is 
pressed and the shift key is not held down. The range of 
values is 1 through 10, with 1 being the slowest speed and 
1 the highest. The terminal interprets values lower than 1 
as 1, and greater than 10 as 10. 
Defaults: Factory = 10 

Power-Up = 10 

Omitted = 1 



shifted-speed: integer; determines the speed at which the 
GIN cursor moves across the screen when the joydisk is 
pressed while the shift key is held down. The range of 
values is 1 through 10, with 1 being the slowest speed and 
1 the highest. The terminal interprets values lower than 1 
as 1 , and greater than 1 as 1 0. 
Defaults: Factory = 1 

Power-Up = 1 

Omitted = 1 



SET GRAPHICS AREA WRITING MODE 

Specifies whether the terminal overwrites or replaces alpha- 
text in the graphics area of the display. 



Host Syntax 



E cMG writing-mode 



Setup Syntax 



GAMODE writing-mode 



writing-mode: integer (keyword in Setup syntax); or replace 
specifies replace, 1 or overstrike specifies overstrike. 
Defaults: Factory = 1 (overstrike) 

Power-Up = Stored in memory 

Omitted = (replace) 

This command affects only how alphatext is displayed in 
the graphics area. If writing-mode is set to overstrike, an 
alphatext character will be displayed on top of an existing 



char; 



ii+hrti it oracinn tha ovictinn rharartfir Vol I mn 
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use overstrike to underline characters with _ (the Under- 
score character). 

Alphatext displayed in the dialog area is not affected by this 
command. (Alphatext is displayed in the dialog area when 
the dialog area is enabled.) SET DIALOG AREA WRITING 
MODE sets overstrike capability for dialog area alphatext. 
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SET GRAPHTEXT ROTATION 

Sets the rotation angle for graphtext. 
Host Syntax 



E cMR mantissa, 

power-of-two 



Setup Syntax 



GTROTATION mantissa, 

power-of-two 



mantissa: integer; indicates the graphtext rotation angle. 
Only the following values are valid: 0, 90, 1 80, and 270. 
However, if other angles are given, the terminal will round 
off to the nearest multiple of 90°. 
Defaults: Factory = 

Power-Up = 

Omitted = 



Setting 


Example 





xABC* 


90 


o 
m 

X 


180 


*oay x 


270 


X 

CD 
O 

* 


Note: Graphtext is "ABC" and character path is in all 
examples. 

x is graphics position before graphtext is displayed. 

* is updated graphics position after graphtext is 
displayed. 

4526-1 8A 



power-of-two: integer; gives the power of two by which the 
mantissa is multiplied. This value is usually 0. 

This command sets the angle of rotation for subsequent 
graphtext. Figure 5-10 shows the four available choices. 
Positive angles represent counterclockwise rotations, while 
negative angles represent clockwise rotations. 

Character path is relative to the rotation angle. See the 
description of SET CHARACTER PATH for an explanation 
of character path and how it relates to rotation angle. 

SET GRAPHTEXT SIZE 

Sets the size of graphtext. 

Host Syntax 



E cMC unused, 
height, 
unused 



Setup Syntax 



GTSIZE unused, 

height, 
unused 



Figure 5-10. Graphtext Rotation Examples. 



unused: integer; provides compatility with other Tektronix 
terminals. You must include an integer even though it is not 
used by this terminal. 

height: integer; indicates the height of subsequent 
graphtext in terminal space units (TSU). 
Defaults: Factory = 61 

Power-Up = 61 

Omitted = Error 

unused: integer; provides compatility with other Tektronix 
terminals. You must include an integer even though it is not 
used by this terminal. 

The terminal can display graphtext in several fixed sizes. 
The smallest available size displays an uppercase letter as 
five pixels wide and seven pixels high. As shown in the 
examples in Table 5-7, the other available sizes are integer 
multiples of the smallest size. The terminal examines the 
height you specify and displays graphtext in the closest 
available size. 
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Changing the size of the window does not change the size 
of existing graphtext. However, if you first change window 
size and then display graphtext, the terminal displays the 
graphtext in the closest available size, based on the height 
you specify. 

Table 5-7 
GRAPHTEXT SIZE PARAMETERS EXAMPLES' 



Specified Height (TSU) 


Resulting Size (Pixels) 


1-87 


5x7 


88-148 


10x14 


149-209 


15x21 



These examples assume the default window size is used. 

SET KEY EXECUTE CHARACTER 

Specifies the character that directs the flow of macro 
expansion. 

Host Syntax 



E cKY key-execute-character 



Setup Syntax 



KEYEXCHAR key-execute-character 



key-execute-character, small integer; specifies the character 

thp+ aqi icpc fha tprminol tr> Hir.aot tha oynancinn rif a mar rn 
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to the host or the terminal. 
Defaults: Factory = 16( d l) 

Power-Up = Saved in memory 

Omitted = ( N u ) 

If the terminal is sending macros to the host, the key- 
execute character means "use what follows locally." If the 
terminal is currently using macros locally, the key-execute 
character means "send what follows to the host." 



Always include the second key-execute character in the 
macro. If you omit the second key-execute character, subse- 
quent macros are expanded at the terminal, even if they are 
intended for the host. This would continue until the terminal 
expands a macro that includes a key-execute character. 



SET LINE INDEX 

Specifies the color index for all subsequent lines, panel 
boundaries, and markers. 

Host Svntax 



E cML line-index 



Setup Syntax 



LINEINDEX line-index 



line-index: integer; indicates the color index for lines, panel 
boundaries, and markers. Must be in the range to 32767 
(values greater than 7 set line-index to 7). 
Defaults: Factory = 1 

Power-Up = 1 

Omitted = 

After this command is issued, all new lines, panel bounda- 
ries, and markers have the specified color index. This con- 
tinues until the terminal receives another SET LINE INDEX 
that changes the color index. 

A host prooram assi n ns a color to a color Index with SET 
SURFACE COLOR MAP. An operator can use the color 
interface (see 4105 Graphics Terminal Operators Manuat) 
or the Setup command CMAR 



4105 PROGRAMMERS 



REV, SEP 1983 



5-45 



41 00 COMMANDS AND REPORTS 
SET LINE STYLE 



SET LINE STYLE 

Specifies the line style for subsequent lines and panel 
boundaries. 

Host Syntax 



E cMV line-style 



Setup Syntax 



LINESTYLE line-style 



line-style: integer; indicates a predefined line style. Must be 
in the range through 7. 
Defaults: Factory = 

Power-Up = 

Omitted = 

Figure 5-1 1 illustrates the line styles. The terminal will dis- 
play all new lines and panel boundaries with the line style 
specified in this command or with 4014 LINE STYLE, which- 
ever was last executed. Existing items are not changed by 
this command. 



SET MARKER TYPE 

Specifies the kind of marker to be drawn. 
Host Syntax 



E cMM marker-number 



Setup Syntax 



MARKERTYPE marker-number 



marker-number, integer; indicates a predefined marker 
type. Must be in the range through 1 0. 
Defaults: Factory = 

Power-Up = 

Omitted = 

Figure 5-1 2 illustrates the marker types. 

When you change marker types, markers already displayed 
remain the same; this command affects only subsequent 
markers. 



Parameter 


1 

2 
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4 
5 
6 
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Figure 5-12. Marker Types. 



Figure 5-1 1 . Line Styles. 
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Specifies the kind of parity the terminal uses when it trans- 
mits to the host. 

Host Syntax 



E cNP parity-mode 



Setup Syntax 



DADITV noritu.mrtHa 



parity-mode: integer (keyword in Setup syntax); or none 
sets parity to 0; 1 or odd causes the terminal to use odd 
parity; 2 or even causes the terminal to use even parity; 3 or 
high sets the parity bit to 1 ; 4 or data causes the terminal to 
use the eighth bit in each character as another data bit. 
Defaults: Factory = (none) 

Power-Up = Saved in memory 

Omitted = 0(none) 

The terminal always ignores the parity bit in characters it 
receives from the host. 



SET PIXEL BEAM POSITION 
(Requires Optional Pixel ROMs) 

Sets the position of the pixel beam in the pixel viewport for 
use by subsequent RASTER WRITE or RUNLENGTH 
WRITE commands. 



Host Syntax 



E cRH beam-position 



Setup Syntax 



PXPOSITION beam-position 



beam-position: xy-coordinate; specifies the position where 
the next RASTER WRITE or RUNLENGTH WRITE com- 
mand will take effect. Values for x range from to 51 1 ; for y, 
from to 359; The position is relative to the lower-left corner 
of the pixel viewport. 
Defaults: Factory = (0,359) 

Power-Up = (0,359) 

Omitted = (0,0) 
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SET PIXEL VIEWPORT 
(Requires Optional Pixel ROMs) 

Sets the pixel viewport position on the pixel writing surface. 

Host Syntax 



E cRS lower-left, 
upper-right 



Satun Cwntov 



PXVIEWPORT lower-left, 
upper-right 



lower-left: xy-coordinate; specifies (in raster memory 
space) one corner of the pixel viewport. Values for x range 
from to 51 1 ; for y, from to 359. 
Defaults: Factory = (0,0) 

Power-Up = Saved in memory 

Omitted = (0,0) 

upper-right: xy-coordinate; specifies the opposite corner of 
the pixel viewport. Values for x range from to 51 1 ; for y, 
from to 359. 
Defaults: Factory = (479,359) 

Power-Up = Saved in memory 

Omitted = (0,0) 

The SET PIXEL VIEWPORT command updates the current 
pixel beam position to the upper-left corner of the pixel 
viewport. The lower-left and upper-right coordinates may 
actually be the coordinates of any two diagonally opposite 
corners of the pixel viewport. The terminal will sort the x- 
and y-coordinate values to determine the correct upper and 
lower corners. 

You can set the viewport's x-direction to include the pixels 
480 to 51 1 , which are off the screen. A level warning will 
be generated, however. 
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SET PROMPT STRING 



Specifies the string that initiates the terminal's Prompt 
mode. 

Host Syntax 



E cNS prompt-string 



Setup Syntax 



PROMPTSTRING prompt-string 



prompt-string: integer array (delimited character string in 

Setup syntax); indicates the string that is a prompt 

sequence when received from the host. Maximum length of 

ten characters. The integer array consists of up to ten ADE 

values representing the characters used as the prompt 

string. 

Defaults: Factory = Empty array 

Power-Up = Saved in memory 

Omitted = Empty array 

See the Communications section for an explanation of 
Prompt mode. 

SET QUEUE SIZE 

Specifies the size (in bytes) of the terminal's input queue. 
Host Syntax 



E cNQ queue-size 



Setup Syntax 



QUEUESIZE queue-size 



queue-size: integer; indicates the size in bytes of the input 
queue. Must be in the range 1 through 65535. 
Defaults: Factory = 300 

Power-Up = Saved in memory 

Omitted = Error 



When the terminal receives data from the host faster than it 
can be processed, it stores the data in the input queue. If 
the input queue fills up and the terminal is not using a flag- 
ging mechanism, the terminal ignores incoming data until 
there is more room in the queue. See the Communications 
section for more details. 

Specifying an input queue that is too large can deplete the 
terminal's memory. This can affect the terminal's ability to 
display panels. 



SET SEGMENT POSITION 

Sets the position where the crosshair cursor will be enabled 
Host Syntax 



E cSX segment-number, 
position 



Setup Syntax 



SGPOSITION segment-number, 
position 



segment-number: integer; must be 0, which identifies the 
crosshair cursor. 

position: xy-coordinate; specifies the position at which the 
terminal displays the crosshair cursor. Requesting a posi- 
tion outside the current window moves the cursor to the 
closest location within the current window but does not 
generate an error. 
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SET SNOOPY MODE 

Specifies whether or not the terminal is in Snoopy mode. 
Host Syntax 



E cKS snoopy-mode 



Setup Syntax 



SNOOPY snoopy-mode 



snoopy-mode: integer (keyword in Setup syntax); the key- 
word no means that the terminal is not in Snoopy mode 
(there is no corresponding integer parameter for Host syn- 
tax); 1 or yes means that the terminal is in Snoopy mode. 
Defaults: Factory = (no) 

Power-Up = (no) 

Omitted = 1 (yes) 

When the terminal is in Snoopy mode, control characters 
are displayed instead of executed (except for l f, which is 
displayed and causes a new display line). You cannot exe- 
cute commands from the host when the terminal is in 
Snoopy mode. 

Snoopy mode cannot be terminated from the host; only the 
operator can do so. To terminate Snoopy mode, press the 
Cancel key or enter SNOOPY no in Setup mode. 

If CRLF mode is not set, the terminal assumes that the host 
will send c r l f at the end of each line. When that is true, the 
terminal starts a new line on the screen after it displays the 
l f character. If CRLF mode is set (yes or 1), the terminal 
assumes that the host will send only c r at the end of a line. 
In that case the terminal starts a new line after displaying 
the c r character. In either case, the l f character is displayed 
and causes the terminal to start a new line. 



number-of-stopbits: integer; indicates the number of stop- 
bits appended to each character the terminal transmits. 
Must have vaiue of 1 or 2. 
Defaults: Factory = 1 

Power-Up = Saved in memory 

Omitted = Error 

See the Communications section for an explanation of 
stopbits. 



SET SURFACE COLOR MAP 

Specifies the color assigned to one or more color indices in 
the graphics area. 



Host Syntax 



E cTG surface-number, 
color-mixture . . . 



Setup Syntax 



CMAP surface-number, 
color-mixture . . . 



surface-number, integer; must have a value of 1 . 

color-mixture: integer array; consists of groups (quadru- 
ples) of four integers. Each quadruple specifies a color 
index (valid range through 7) and the HLS coordinates of 
the color being assigned to that index: hue (a valid range of 
-32768 through 32767), lightness (a valid range of to 1 00), 
and saturation (a valid range of to 1 00). As in any integer 
array, the first element in the array specifies the number of 
following elements. 
Defaults: Factory = See Table 5-8 

Power-Up = Saved in memory 

Omitted = Error 



SET STOP BITS 

Specifies number of stopbits appended to each character 
the terminal transmits. 

Host Syntax 



E cNB number-of-stopbits 



Setup Syntax 



STOPBITS number-of-stopbits 
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When you specify a color in most commands, you use a 
color index, which is an integer in the range through 7. 
SET SURFACE COLOR MAP defines the color for one or 
more graphics area color indices. The dialog area has its 
own set of color indices, which is defined with SET DIALOG 
AREA COLOR MAP. 

For example, the following command in Host syntax speci- 
fies white (HLS coordinates 0, 1 00, 0) for Index 3 in the 
graphics area: 

E cTG430F40 

Note that the first 4 indicates that four values follow. 

In Setup syntax, this command is: 
CMAP 130100 

The Graphics Terminal section and the Tektronix Color 
Standard appendix have details on how the terminal dis- 
plays colors. 

Table 5-8 shows the default colors assigned to color indices 
when the terminal is manufactured. 



SET TAB STOPS 

Sets tab stop(s) at the specified position(s). 
Host Syntax 



E cKB tab-positions 



Setup Syntax 



TABS tab-positions 



tab-positions: integer array (can be a keyword in Setup 
syntax); specifies one or more tab stops. The keyword all 
can be used in Setup mode to set tab stops at every column. 
Specify to clear all tab stops; specify -1 or all to set tab 
stops at every column; specify -2 to reset tab stops to fac- 
tory default. 

Defaults: Factory = 1 , 9, 17, 25, 33, 41 , 49, 57, 65, 
73,80 

Power-Up = Saved in memory 

Omitted = 



Table 5-8 
FACTORY DEFAULT COLOR INDICES 



Color 


Color Mixture 


Color Coordinates* 


Index 


H 


L 


S 





Black 











1 


White 





100 





2 


Red 


120 


50 


100 


3 


Green 


240 


50 


100 


4 


Blue 





50 


100 


5 


Cyan 


300 


50 


100 


6 


Magenta 


60 


50 


100 


7 


Yellow 


180 


50 


100 



H = hue, L = lightness, S = saturation 



SET TEXT INDEX 

Specifies the color index for alphatext and graphtext in the 
graphics area. 

Host Syntax 



E cMT text-index 



Setup Syntax 



GTINDEX text-index 



text-index: integer; specifies a color index for text in the 
graphics area. Must have a value in the range of through 7 
(values greater than 7 specify Index 7). 
Defaults: Factory = 1 

Power-Up = 1 

Omitted = 
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This command sets the color index for all new text displayed 
in the graphics region. This includes all graphtext and 
aiphatext displayed when the dialog area is disabled. This 
command does not change the color index of existing text. 

Aiphatext displayed in the dialog area is not affected by this 
command. Use SET DIALOG AREA INDEX to set the color 
index of dialog area aiphatext. 



SET TRANSMIT DELAY 



Specifies the period of time the terminal delays after trans- 
mitting one line of text before it transmits the next. 



Host Syntax 



E cND transmit-delay 



Setup Syntax 



XMTDELAY transmit-delay 



transmit-delay: integer; indicates the period of delay in 

milliseconds. Must have a value from to 65535. (The 

actual period of time may be up to 33 milliseconds longer 

than that specified because of the resolution of the internal 

timer.) 

Defaults: Factory = 100 

Power-Up = Saved in memory 

Omitted = 



SET TRANSMIT RATE LIMIT 

Specifies the effective transmit baud rate limit. 



Host Syntax 



E cNL rate-limit 



Se tup Syntax 



XMTLIMIT rate-limit 



rate-limit: integer; specifies the terminal's transmit rate 
limit. Must be In the range 1 10 through 65535. 
Defaults: Factory = 13200 

Power-Up = Saved in memory 

Omitted = Error 



SET VIEW ATTRIBUTES 

Sets the background color for the graphics area. 
Host Syntax 



^RA surface, 

background-index, 
unused 



Setup Syntax 



VIEWATTRIBUTES surface, 

background-index, 
unused 



surface: integer; provides compatibility with other Tektronix 
terminals. Must be 1 or -1 . 
Defaults: Factory = 1 

Power-Up = 1 

Omitted = Error 

background-index: integer; indicates the color index of the 
graphics area background. Must be in the range through 7. 
Defaults: Factory = 

Power-Up = 

Omitted = Error 

unused: integer; any valid integer is allowed. Provides com- 
patibility with other Tektronix terminals. 

This command sets the background color for the graphics 
area. The graphics area is this color before anything is 
displayed in it and immediately after it is cleared. The color 
is specified as one of the eight graphics area color indices 
defined by SET SURFACE COLOR MAR When you change 
the background color, you do not see the new color until the 
screen is cleared. 

The first and third parameters are included in this command 
for compatibility with other Tektronix terminals. 
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SET WINDOW 

Establishes the boundaries of the current window in termi- 
nal space. 

Host Syntax 



E cRW lower-left-corner, 
upper-right-corner 



Setup Syntax 



WINDOW lower-left-corner, 
upper-right-comer 



lower-left-corner, xy-coordinate; specifies the location of 
the lower-left corner of the window. 
Defaults: Factory = (0,0) 

Power-Up = Remembered 

Omitted = (0,0) 

upper-right-corner: xy-coordinates; specifies the location of 
the upper-right corner of the window. 

Defaults: Factory = (4095,3132) 
Power-Up = Remembered 
Omitted = (4095,3132) 

This command specifies a rectangular area in terminal 
space, called the window. The terminal then displays this 
window so that it fills the screen. The two corners you spec- 
ify are placed at the corresponding corners of the screen. 
The dialog area might obscure part of the window since the 
dialog area is displayed on top of the graphics area. 

If you do not specify two corners of a window with the same 
aspect ratio as the screen, the display will be linearly dis- 
torted. You can prevent a distorted display by specifying a 
window with height or width. The terminal will then auto- 
matically replace the value with a value that produces an 
undistorted display. To indicate width, specify the same 
x-coordinate for both corners. To indicate height, specify 
the same y-coordinate for both corners. 

The factory default window produces a display that has a 
slight linear distortion, but is compatible with other Tektronix 
terminals. A window of (0,0), (4095,3071) produces an 
undistorted image and allows the maximum number of 
addressable locations. 

The window (0,0), (479,359) lets you individually address 
each pixel. 



SET 4014 LINE STYLE 

Specifies line styles compatible with Tektronix 401 and 
4110 Series terminals. 

Host Syntax 



E c line-style-code 



line-style-code: single character; specifies a line style as 
shown in Table 5-9. 

This command does the same thing as SET LINE STYLE. 
The line style for lines, markers, and panel boundaries is set 
by the last SET LINE STYLE or SET 401 4 LINE STYLE, 
whichever occurred most recently. 

SET 4014 LINE STYLE sets line styles that are available on 
other Tektronix terminals. This lets you emulate other termi- 
nal's displays. 

Codes h through o indicate line styles that are displayed 
with a defocused beam on TEKTRONIX 4014,4016, and 
41 14 Terminals. The 4105 Terminal does not defocus these 
lines. 

Table 5-9 
LINE STYLE CODES 



Character 


Line Style 


Emulated Terminals 


- 


Solid lines 


4014/4016 


a 


Dots 


4014/4016 


b 


Dot-dashes 


4014/4016 


c 


Short-dashes 


4014/4016 


d 


Long dash 


4014/4016 


e 


Dash-dot-dot-dot 


4112/4113/4114 


f 


Long dot-dashes 


4112/4113/4114 


g 


Long dots 


4112/4113/4114 


h 


Solid lines 


4014/4016/4114 


i 


Dots 


4014/4016/4114 


J 


Dot-dashes 


4014/4016/4114 


k 


Short-dashes 


4014/4016/4114 


I 


Long dash 


4014/4016/4114 


m 


Dash-dot-dot-dot 


4014/4016/4114 


n 


Long dot-dashes 


4014/4016/4114 





Long dots 


4014/4016/4114 



5-52 



REV, SEP 1983 



4105 PROGRAMMERS 



4100 COMMANDS AND REPORTS 
4010HARDCOPY 



STATUS 



4010HARDCOPY 



Displays the current parameter vaiues ior a cornrnanu or 
cluster of commands. 



Setup Syntax 



STATUS name 



name: string; the Setup command name or command clus- 
ter name for which you want the current parameter values. 
While in Setup mode, type STATUS to display the valid 
command names and command cluster names. 
Default: Omitted = All commands 

Alternatively, you can use E c followed immediately by a two- 
character opcode for a Tek mode command. The characters 
of the opcode must be typed in capital letters. 



Generates a hardcopy of the entire screen. 



Host Syntax 




This command has the same effect as pressing the S Copy 
key. 

If you copy the dialog area, during the time the copy is being 
made, the dialog area will not show your dialog with the 
host. To avoid copying the dialog area, press the Dialog key 
to make the dialog area invisible. After the copy starts, you 
can press the Dialog key to make the dialog area visible. 
This lets you use the dialog area while the copy is being 
made. 
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Table A-1 
ASCII (IS0-7-US) CODE CHART 





B7 

Be 




VI«V 

V i 1 


1 



I 


% 


1 0. 
I 


1 % 


^1 


bllS 

B4 B3 B2 Bl 


CONTROL 


FIGURES 


UPPERCASE 


LOWERCASE 














NU 




DL 

76 


SP 

32 




48 


@ 

64 


P 

80 


\ 

96 


P 

772 











1 


SH 

1 


D1 

17 


! 

33 


1 

49 


A 

65 


Q 

81 


a 

97 


q 

113 








1 





sx 

2 


D2 

78 


it 

34 


2 

50 


B 

66 


R 

82 


b 

98 


r 

774 








1 


1 


EX 

3 


D3 

79 


# 

35 


3 

51 


c 

67 


S 

83 


c 

99 


s 

7 75 





1 








ET 

4 


D4 

20 


$ 

36 


4 

52 


D 

68 


T 

84 


d 

700 


t 

776 





1 





1 


EQ 

5 


NK 

27 


% 
37 


5 

53 


E 

69 


u 

85 


e 

707 


u 

777 





1 


1 





AK 

6 


SY 

22 


& 

38 


6 

54 


F 

70 


V 

86 


f 

702 


V 

778 




1 
i 


-i 


^ 
i 


Rl 

7 


FR 

l_l_r 

23 


/ 

39 


7 

/ 

55 


r. 

71 


»» 

87 


n 

5 

703 


119 













BS 

8 


CN 

24 


( 

40 


8 

56 


H 

72 


X 

88 


h 

704 


X 

720 










1 


HT 

9 


EM 

25 


) 

47 


9 

57 


I 

/3 


Y 

89 


i 

705 


y 

727 







1 





LF 

70 


SB 

26 


* 

42 


m 
■ 

58 


J 

74 


I 

90 


J 

706 


z 

722 







1 


1 


VT 

7) 


EC 

27 


+ 
43 


59 


K 

75 


[ 

97 


k 

707 


{ 
723 




1 








FF 

12 


FS 

28 


44 


< 

60 


L 

76 


\ 
92 


1 

708 


I 
724 




1 





1 


CR 

73 


GS 

29 


45 


67 


M 

77 


] 

93 


m 

709 


} 

725 




1 


1 





SO 

14 


RS 

30 


■ 

46 


> 

62 


N 

78 


A 

94 


n 

770 


126 




1 


1 


1 


SI 

75 


US 

37 


/ 

47 


? 

63 




79 


~~ 95 




777 


DT 

727 
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ALTERNATE CHARACTER SETS 



This appendix lists the character sets available for use on 
the terminal. These character sets are defined in the ANSI 
X3.41 and ISO 2022 documents. 

Each optional keyboard has a character set that corres- 
ponds to its special characters. When you plug a keyboard 
into the terminal, this character set is automatically selected 
as both the GO and G1 character sets. For example, the 
ASCII character set is selected for the North American key- 
board, while the German character set is selected for the 
Option 4G German keyboard. 

You can designate any two of the character sets as the GO 
and G1 sets and easily switch between them. The GO set is 
selected by sending a s i (Shift In) character to the terminal, 
which causes the GO character set to replace the current 
character set in the terminal. The G1 set is selected by 
sending a s o (Shift Out) character to the terminal, which 
causes the G1 character set to replace the current GO char- 
acter set in the terminal. Refer to the description of the SCS 
(Select Character Set), s i (Shift In), and s o (Shift Out) com- 
mands in the Screen Editor Support section of this manual 
for more information. 

These alternate character sets are defined in the following 
tables. 



Table B-1 
ASCII CHARACTER SET 

(Designated by v/onnGC*ing mC wionwo'w 
North American Keyboard) 





B7 B6 


B5 


•'. 


^1 


1 



^ 


1 % 


X 


'\ 


11 1 


BITS 

84 B3 B2 Bl 


CONTROL 


FIGURES 


UPPERCASE 


LOWERCASE 














NU 




DL 

16 






48 


64 


P 
80 


\ 

96 


P 

112 











1 


SH 

1 


D1 

17 


I 

33 


1 
49 


A 

65 


Q 

81 


a 

97 


q 

7)3 








1 





sx 

2 


D2 

18 


rr 

34 


2 

50 


B 

66 


R 

82 


b 

98 


r 

774 








1 


1 


EX 

3 


D3 

19 


# 
35 


1 

51 


c 

67 


s 

83 


c 

99 


s 

775 





1 








ET 

4 


D4 

20 


$ 

36 


4 

52 


D 

68 


T 

84 


d ! t 

100\ 116 





1 





1 


EQ 

5 


NK 

21 


% 

37 


5 | E 

53 69 


u 

85 


e 

101 


u 

777 





1 


1 





AK 

6 


SY 

22 


& 

38 


6 

54 


F 

70 


V 

86 


f 

702 


V 

7 78 


i i 


1 


1 


BL 

7 


EB 

23 


/ 

39 


7 

55 


G 

71 


W g 

87j 103 


w 
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1I0 








BS 

s 


CN 

24 


( i 8 

40 1 56 


H 

72 


X 

88 


h 

104 


X 

720 


1 ! ,0 





1 


HT 

9 


EM 

25 


) 9 

L 41 57 


1 

73 


Y 

89 


i 

ro5 


y 

727 







1 





LF 

m 


SB 

26 


* : 

42 58 


J 

74 


1 \ i 

90\ 106 


z 

722 







1 


1 


VT 

11 


EC 

27 


+ ; 

43 59 


K 

75 


I k 

91 107 


{ 
723 




1 








FF 

72 


FS ' , < 

281 44 60 


L \ 1 

76i 92i 108 


I 

724 


1 M 


0;1 


CR GS | 

13' 29 | 45 61 


M ] m } 

77\ 93i I09i 125 


1,1(1 !0 


SO RS . > N ■ A | n ~ 

14: 30\ 46 62J TB\ 94 1 110 ; 126 


1 1 jl 11 


SI US / ? o 

15, 31\ 47 63| 79\ 95 111 
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Table B-2 
UNITED KINGDOM CHARACTER SET 

(Designated by connecting the Option 4A keyboard) 



B7 
B 


B5 


% 


\ 


1 



S 


1 % 


1 »1 


1 % 


11 1 


B4 B3 B2 Bl 


CONTROL 


FIGURES 


UPPERCASE 


LOWERCASE 











l\IU 




DL 

16 


SP 

32 




48 


@ 

64 


P 

SO 


\ 
96 


p 

112 








1 


SH 

t 


D1 

17 


I 

33 


1 

49 
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65 


Q 

81 


a 

97 


q 
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1 





sx 

2 
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18 


34 


2 

50 


B 

66 


R 

82 


b 

98 


r 
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1 


EX 

3 


D3 

19 


# 

35 


3 

51 


c 

67 


S 

83 


c 

99 


s 
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20 
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52 
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84 
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21 
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6 
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22 
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38 
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54 


F 

70 
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86 
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V 

118 


1 
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1 
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7 
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23 
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39 
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71 
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24 


( 
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56 
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72 
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88 


h 

104 


X 
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1 





1 


HT 

9 


EM 

25 


) 

41 


9 

57 


1 

73 


Y 

89 


i 
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y 
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1 


1 





LF 

10 


SB 

26 


* 

42 


58 


J 

74 


z 

90 
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1 


1 


1 


VT 

11 


EC 

27 


+ 
43 


59 


K 

75 


I 

91 


k 
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FF 

12 
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28 


44 


< 

60 


L 

76 


\ 

92 
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I 
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1 


CR 

13 


GS 

29 


45 


61 


M 

77 


] 

93 


m 
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} 
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1 





SO 

14 


RS 

30 


46 


> 

62 


N 

78 


A 

94 


n 

110 
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1 


1 


SI 

15 
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? 
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DT 
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Table B-3 
FRENCH CHARACTER SET 

(Designated by connecting the Option 4B keyboard) 
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B6 

B5 
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s 
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Table B-4 
SWEDISH CHARACTER SET 

(Designated by connecting the Option 4C keyboard) 



Table B-5 
DANISH/NORWEGIAN CHARACTER SET 

(Designated by connecting the Option 4F keyboard) 
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Table B-6 
GERMAN CHARACTER SET 

(Designated by connecting the Option 4G keyboard) 



Table B-7 
SUPPLEMENTARY CHARACTER SET 





B7 B6 


B5 
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X 
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^1 
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CONTROL 


FIGURES 
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DL 

76 
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32 




48 
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P 

772 
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SH 
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45 
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ALTERNATE CHARACTER SETS 
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Appendix C 
ERROR CODES 



INTRODUCTION 

Each error that the terminal detects has an error code and a 
severity level. 

When the terminal detects an error It stores the error in a 
iimited-size queue for later retrieval by the REPORT 
ERRORS command. 

If the errors severity level is greater than or equal to the cur- 
rent error level, the terminal displays a message for the 
operator. When the terminal is shipped from the factory, its 
error threshold is set to 2; thus the only errors displayed are 
those with a severity level of 2 or 3. The error threshold can 
be changed with the SET ERROR THRESHOLD command 
(ERROR LEVEL in Setup Syntax). The error threshold is not 
remembered when the terminal is turned off. 



ERROR CODES 

The error codes are composed according to the following 
scheme: 

• Each error code consists of four characters. 

• In most error codes the first two characters are the op- 
code, an abbreviated code that identifies the command 
that caused the error. 

• The third character is a digit. Digits from 1 to 9 name the 
parameter with which the error is associated; a indi- 
cates that the error is associated with the command as a 
whole. 

• The fourth character of the error code is also a digit: 

Indicates an existence problem. The object referred 
to does not exist when it should, or it does exist 
when it shouldn't. 

1 Indicates an invalid value. 

2 Indicates an out-of -memory problem. 

3 Indicates a context problem. The command is 
valid, but cannot be executed at this time. 



For example, consider the MP10 error code. Here "MP" 
refers to the Select Fill Pattern command, which has the fol- 
lowing syntax: 



E„MD fill 






-nun 



The "1" refers to the first (and only) parameter of that com- 
mand, which is the fill pattern number. The "0" indicates an 
existence problem; the fill pattern does not exist. 

SEVERITY LEVELS 

There are four error severity levels: 

• Level 0. Errors of severity level are minor errors. The 
corresponding message begins with, "Terminal issues 
message . . . ." 

• Level 1 . Level 1 errors are warnings. The corresponding 
message begins with, "Terminal issues warning 
Typically these warnings occur when the command is 
inappropriate or not recognized. 

• Level 2. Level 2 errors result from invalid commands. 
The corresponding message begins with, "Terminal 
detects error . . . ." For instance, a parameter may be 
outside the specified range. 

• Level 3. Level 3 errors occur when the command is 
valid, but the terminal cannot execute the command. 
The corresponding message begins with, "Terminal sys- 
tem error . . . ." For instance, there may be insufficient 
memory to hold all the information being entered. 
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ERROR CODES 

The rest of this appendix lists each error code alphabetically 
with its severity level and an explanation of the cause. 

IU1 1 (Level 2). Invalid speed in parameter 1 (must be in 
range through 65535). 

IU21 (Level 2). Invalid speed in parameter 2 (must be in 
range through 65535). 

JC11 (Level 2). Invalid source device specifier (must be 
"HC:"). 

JC12 (Level 3). Out of memory while parsing the first 
parameter. 

JC21 (Level 2). Invalid separator string (must be a < NU > 
character or the string "TO"). 

JC22 (Level 3). Out of memory while parsing the second 
parameter. 

JC31 (Level 2). Invalid destination device specifier. Must be 
the string "HO:". 

JC32 (Level 3). Out of memory while parsing the third 
parameter. 

JC39 (Level 2). Hard copy device not ready. Check the 
hard-copy unit. 

KA03 (Level 1). Context problem, cannot disable dialog 
area when in Ansi or Edit mode. 

KA1 1 (Level 2). Parameter out of range (must be or 1 ). 

KB12 (Level 2). Out of memory while parsing the array. 

KD1 1 (Level 2). Invalid macro number (must be in range 
-150 to 32767). 

KD21 (Level 2). Invalid character-code in the ASCII-deci- 
mal-equivalents parameter. (Character codes must be in the 
range from to 127. The array count must be in the range 
from to 65535.) 

KD22 (Level 3). Insufficient memory to define macro. 

KE11 (Level 2). Invalid echo mode (must be or 1). 

KF1 1 (Level 2). Invalid LFCR mode (must be or 1). 

KH1 1 (Level 2). Invalid hardcopy code (must be 0, 1 , 2, or 3). 



KM 1 (Level 2). Invalid ignore-deletes mode (must be 
or1). 

KL1 1 (Level 2). Invalid keyboard-lock mode (must be 
or1). 

K01 1 (Level 2). Invalid macro number (must be in the range 
-150 to 32767). 

K021 (Level 2). Invalid character-code in the ADE parame- 
ter (character codes must be in the range to 1 27; the array 
count must be in the range to 65535). 

K022 (Level 3). Insufficient memory to define macro. 

KR1 1 (Level 2). Invalid "CR-implies-LF" mode (must be 
or1). 

KS1 1 (Level 2). Invalid parameter (must be or 1) 

KT1 1 (Level 2). Invalid error threshold (must be in the range 
0to4). 

KU02 (Level 2). Nonvolatile memory hardware error. 

KW1 1 (Level 2). Invalid mode (must be or 1). 

KX01 (Level 2). The maximum nesting depth for the 
EXPAND-MACRO command has been exceeded. The nest- 
ing depth should not exceed five. Greater nesting depths 
may result in KX01 errors. 

KX02 (Level 3). Out of memory while performing EXPAND- 
MACRO command. 

KX11 (Level 2). Invalid macro identifier (must be in the 
range from -1 50 to 32767). 

KY11 (Level 2). Invalid key-execute-delimiter code (must be 
in range to 127). 

KZ11 (Level 2). Invalid character-delete character (must be 
in range through 1 27). 

KZ21 (Level 2). Invalid line-delete character (must be in 
range through 127). 

KZ31 (Level 2). Invalid take-literally character (must be in 
range through 127). 

LB03 (Level 0). Dialog parameters modified. 
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LB1 1 (Level 2). Invalid number-of-lines parameter (must be 
in the range from 2 to 32767). 

LE02 (Level 3). Out of memory while performing END- 
PANEL command. 

LE03 (Level 1). No panel is currently being defined. 

LI11 (Level 2). Invalid character index (must be in the range 
from to 65535). 

LI21 (Lave! 2). Invalid character background Index (must be 
in the range from to 65535). 

LI31 (Level 2). Invalid dialog area wipe index (must be in 
the range from to 65535). 

LL1 1 (Level 2). Invalid parameter (must be in the range of 2 
through 30. 

LM1 1 (Level 2). Invalid writing mode (must be or 1). 

LP02 (Level 2), Out of memory while defining a panel. 

LP03 (Level 2). Alphatext is not allowed within a PANEL- 
DEFINITION. When the terminal is in alpha mode, be sure 
the dialog area is enabled; otherwise, the terminal attempts 
to read alpha-text as xy parameters. 

LP21 (Level 2). Invalid "draw boundary" mode (must be in 
the range of -32768 to 32767). 

LT03 (Level 2). Command is invalid at this time. Graphtext 
is not allowed within a PANEL-DEFINITION. When this error 
is detected, the panel being defined is closed, as if an END- 
PANEL command were received. 

LT11 (Level 2). Invalid graphtext string. Invalid array count 
(must be in range from to 32767), or invalid character in 
the array (must be in the range from s p to ( ~ ) — decimal 
equivalents from 32 to 1 26). 

LT12 (Level 3). Parameter 1 memory error (out of memory 
while parsing the string parameter). 

LV1 1 (Level 2). Invalid dialog area visibility mode (must be 
or1). 

MC21 (Level 2). Invalid value in parameter 2. 

MG1 1 (Level 2). Invalid parameter (must be or 1). 

ML11 (Level 2). Invalid line index (must be in the range from 
to 32767). 



MM1 1 (level 2). Invalid marker type (must be in the range 

from to 1 0) 

MN11 (Level 2). Invalid rotation angle (must be either 0, 90, 
180, or 270). 

M01 1 (Level 2). Invalid rotation angle (must be either 0, 90, 
180, or 270). 

MP10 (Level 2). Specified fill pattern does not exist. 

MP1 1 /I aual 0\ Inyalirl fill nattorn ni imhpr fmiiQt ho in tho 

range from -32768 to 1 6 or 50 to 1 74). 

MR1 1 (Level 2). Invalid rotation angle (must be in range 
-32767 through 32767). 

MT11 (Level 2). Invalid text index (must be in the range 
from to 65535). 

MV11 (Level 2). Invalid line style (must be in the range from 
to 7). 

NB1 1 (Level 2). Invalid number of stop bits (must be 1 or 2). 

NC1 1 (Level 2). Invalid value in parameter 1 . Gan be any 
ASCII character. 

NC21 (Level 2). Invalid value in parameter 2. Can be any 
ASCII character. 

ND1 1 (Level 2). Invalid transmit delay time (must be in the 
range from to 65535 milliseconds). 

NE11 (Level 2). Invalid EOF-string (must contain from to 
1 characters, with each character represented by an int in 
the range from to 1 27). 

NE12 (Level 3). Parameter 1 memory error (out of memory 
while parsing the end-of-file-string parameter). 

NF1 1 (Level 2). Invalid flagging mode (must be in the range 
from to 4). 

NK1 1 (Level 2). Invalid parameter (must be in the range 
from to 65535). 

NL11 (Level 2). Invalid transmit rate limit (must be in the 
range 110 to 38400). 

NM1 1 (Level 2). Invalid prompt mode parameter (must be 0, 
1,or2). 

NP1 1 (Level 2). Invalid parity code (must be in the range 
from to 4). 
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NQ02 (Level 3). Out of memory while performing SET- 
QUEUE-SIZE command. 

NQ1 1 (Level 2). Invalid queue size (must be in the range 
from 1 to 65535). 

NR11 (Level 2). Invalid transmit (terminal-to-host) data rate 
(must be either 1 , 75, 1 10, 134, 150, 300, 600, 1200, 1800, 
2000, 2400, 4800, 9600, 19200, or 38400). 

NR21 (Level 2). Invalid receive (host-to-terminal) data rate 
(must be either 0, 1 , 75, 1 1 0, 1 34, 1 50, 300, 600, 1 200, 
1800, 2000, 2400, 4800, 9600, 19200, or 38400). 

NS1 1 (Level 2). Invalid prompt-string parameter (must be 
an array of up to 1 ASCII characters). 

NS12 (Level 3). Parameter 1 memory error (out of memory 
while parsing the prompt-string parameter). 

NT1 1 (Level 2). Invalid array count in EOL-string. The array 
must hold from to 2 int parameters. Each int in the array 
must be in the range from to 1 27. 

NT12 (Level 3). Parameter 1 memory error (out of memory 
while i parsing the EOL-sTffng parameter). 

NU11 (Level 2). Invalid numeric equivalent of bypass-can- 
cel character (must be in the range from to 255). 

QA1 1 (Level 2). Invalid copy size (must be or 1 ). 

QD1 1 (Level 2). Invalid copier value. 

QL1 1 (Level 2). Invalid page number. 

QL21 (Level 2). Invalid page origin. 

QL31 (Level 2). Invalid FF value. 

RA11 (Level 2). Invalid surface number (must be -1 or 1). 

RA21 (Level 2). Invalid background index (must be in range 
through 65535). 

RA31 (Level 2). Invalid value (must be in range through 
65535). 

RP1 1 (Level 2). Invalid number of pixels (must be in the 
range through 65535). 

RP21 (Level 2). There are too many or too few pixels in the 
code array. 



RP22 (Level 3). Parameter 2 memory error (out of memory 
while parsing the character-array parameter. 

RR1 1 (Level 0). Invalid lower-left coordinates (x value is 
between range of 480 and 51 1). 

RR1 1 (Level 2). Invalid lower-left coordinates (x must be in 
the range through 51 1 , and y from through 359). 

RR21 (Level 0). Invalid upper-right coordinates (x value is 
between range of 480 and 511). 

RR21 (Level 2). Invalid upper-right coordinates (x must be 
in the range through 51 1 , and y from through 359). 

RR31 (Level 2). Invalid fill-index (must be in range 
through 65535). 

RS1 1 (Level 0). Invalid lower-left coordinate (x value is 
between range of 480 and 51 1). 

RS11 (Level 2). Invalid lower-left coordinate (x must be in 
the range through 51 1 , and y from through 359). 

RS21 (Level 0). Invalid upper-right coordinate (x value is 
between range of 480 arid5n). 

RS21 (Level 2). Invalid upper-right coordinate (x must be in 
the range through 51 1 , and y from through 359). 

RU10 (Level 2). Surface does not exist. 

RU11 (Level 2). Invalid surface number (must be in the 
range -1 through 4). 

RU21 (Level 2). Invalid ALU mode (must be 0,7, 11, 12, 15). 

RU31 (Level 2). Invalid bits-per-pixel (must be 0, 1 , 2, 3, 4, 
or 6). 

RX1 1 (Level 2). Invalid destination surface (must be in the 
range -1 to1). 

RX21 (Level 0). Invalid destination lower-left corner (x must 
be in range through 479 and y in range through 359). 

RX21 (Level 2). Invalid destination lower-left corner (x must 
be in range through 51 1 and y in range through 359). 

RX31 (Level 0). Invalid first source-corner (x must be in 
range through 479 and y in range through 359). 

RX31 (Level 2). Invalid first source-corner (x must be in 
range through 51 1 and y in range through 359). 
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RX41 (Level 0). Invalid second source-corner (x must be in 
range through 479 and y in range through 359). 

RX41 (Level 2). Invalid second source-corner(x must be in 
range through 51 1 and y in range through 359). 

SX1 (Level 2). Segment does not exist (must be 0). 

TC1 1 (Level 2). Invalid hue value (must be between -32768 
and 32767). 

TC21 (Level 2). Invalid lightness value (must be between 
and 100V 

TC31 (Level 2). Invalid saturation value (must be between 
and 100). 

TD1 1 (Level 2). Invalid index value (must be between and 
65535). 

TD21 (Level 2). Invalid index value (must be between and 
65535). 

TF1 1 (Level 2). Invalid color-mixtures array (must be an 
array of quadruples consisting of a color index and the three 
HLS color coordinates). 

TF12 (Level 3). Parameter 2 memory error (out of memory 
while parsing the color-mixtures array). 

TF21 (Level 2). Invalid color-mixtures array (must be an 
array of quadruples consisting of a color index and the three 
HLS color coordinates). 

TG1 1 (Level 2). Invalid surface number (must be 1 or -1 ). 

TG21 (Level 2). Invalid color-mixtures array (must be an 
array of quadruples consisting of a color index and the three 
HLS color coordinates). 

TG22 (Level 3). Parameter 2 memory error (out of memory 
while parsing the color-mixtures array). 

[A1 1 (Level 2). Invalid value (must be in the range of to 
32767). 

[B1 1 (Level 2). Invalid value (must be in the range of to 
32767). 

[C1 1 (Level 2). Invalid value (must be in the range of to 
32767). 

[D1 1 (Level 2). Invalid value (must be in the range of to 
32767). 



[f11 (Level 2). Invalid value for parameter 1 (must be in the 
range of to 32767). 

[f21 (Level 2). Invalid value for parameter 2 (must be in the 
range of to 32767). 

[g11 (Level 2). Invalid value (must be 0, 2 or 3). 

[h10 to [h90 (Level 2). Invalid mode value (must be either 2, 
4, 12, 20, < 1 , ?1 , ?3, ?5, ?6, ?7, or ?8). 

[hi 1 to [h91 (Level 2). Invalid parameter syntax. 

[H1 1 (Level 2). Invalid value for parameter 1 (must be in the 
range of to 32767). 

[H21 (Level 2). Invalid value for parameter 2 (must be in the 
range of to 32767). 

[11 1 (Level 2). Invalid value (must be in the range of to 
32767). 

[J1 1 (Level 2). Invalid value (must be 0, 1 or 2). 

[K1 1 (Level 2). Invalid value (must be 0, 1 or 2). 

[101 (Level 2). Invalid mode value (must be either 4, 20, < 1 , 
?1,?3, ?6,?7,or?8). 

[11 to [I90 (Level 0). Unrecognized mode value (treated as 
a no-op). 

[11 1 to [191 (Level 2). Invalid parameter syntax. 

[L1 1 (Level 2). Invalid value (must be in the range of to 
32767). 

[ml 1 (Level 2). Invalid rendition value (must be either 0, 1 , 
4, 5, 7, <, >,or =). 

[M1 1 (Level 2). Invalid value (must be in the range of to 
32767). 

[n1 1 (Level 2). Invalid value (must be 0, 3, 5, or 6). 

[P1 1 (Level 2). Invalid value (must be in the range of to 
32767). 

[r1 1 (Level 2). Invalid value for parameter 1 (must be in the 
range of to 32767). 

[r21 (Level 2). Invalid value for parameter 2 (must be in the 
range of to 32767). 
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JS1 1 (Level 2). Invalid value (must be in the range of to 
32767). 

P"1 1 (Level 2). Invalid value (must be in the range of to 
32767). 

[X11 (Level 2). Invalid value (must be in the range of to 
32767). 

[Z1 1 (Level 2). Invalid value (must be in the range of to 
32767). 



[@11 (Level 2). Invalid value (must be in the range of to 
32767). 

%!1 1 (Level 2). Invalid parameter (must be 0, 1 , 2, or 3). 

#!11 (Level 2). Invalid parameter (must be 0). 

s rA1 1 (Level 2). Invalid value (must be to 32767). 

s p@1 1 (Level 2). Invalid value (must be to 32767). 
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PARAMETER DEFAULT VALUES 



This appendix contains tables listing the terminal com- 
mands that take parameters. The commands are listed 
alphabetically in three tables: 

• 41 OO-Style parameters 

• ANSI-Style parameters 

• Setup mode n arameters 



Commands that are not listed in the tables do not have 
parameters. Parameter default values are shown under the 
appropriate heading. 



Table D-1 
41 OO-STYLE PARAMETER DEFAULTS 





Setup Name 


Host 
Op-Code 


Parameters 


Defaults 


Saved In 
Nonvolatile 


Descriptive Name 


Factory 


Omitted 


Memory 


BEGIN PANEL BOUNDARY 


BEGINPANEL 


LP 


first-point 




0,0 






draw-boundary 









COPY 


COPY 


JC 


source 




error JC 11 






separator 




error JC21 






destination 




error JC31 




CRLF 


CRLF 


KR 


crlf-mode 





1 


YES 


DEFINE MACRO 


DEFINE 


KD 


macro-number 











macro-contents 




empty array 




Qcpjryjc NONVOLATILE MACRO 


NVDEFINE 


KO 


rri3cro~nLirnbsr 




o 


YES 




macro-contents 




empty array 


YES 


DRAW 


DRAW 


LG 


position 




0,0 




DRAW MARKER 


MARKER 


LH 


marker-position 




0,0 




ENABLE DIALOG AREA 


DAENABLE 


KA 


enable-mode 


1 


1 


YES 


ENABLE KEY EXPANSION 


KEYEXPAND 


KW 


switch 


1 


1 




EXPAND MACRO 


EXPAND 


KX 


macro-number 









GRAPHIC TEXT 


GTEXT 


LT 


text 




empty string 




HARDCOPY 




KH 


hard-copy-code 









IGNORE DELETES 


IGNOREDEL 


Kl 


ignore-deletes-mode 





1 


YES 


LFCR 


LFCR 


KF 


Ifcr-mode 





1 


YES 


LOCK KEYBOARD 




KL 


lock-mode 





1 




MOVE 


MOVE 


LF 


position 




0,0 




PROMPT MODE 


PROMPTMODE 


NM 


prompt-mode 





1 
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Table D-1 (cont) 
4100-STYLE PARAMETER DEFAULTS 





Setup Name 


Host 
Op-Code 


Parameters 


Defaults 


Saved In 
Nonvolatile 


Descriptive Name 


Factory 


Omitted 


Memory 


REPORT TERMINAL SETTINGS 




IQ 


inquiry-code 









SELECT CODE 


CODE 


%! 


syntax 








YES 


SELECT FILL PATTERN 


FILLPATTERN 


MP 


fill-pattern-number -1 









SELECT HARDCOPY INTERFACE 




QD 


copier-type 








YES 


SELECT ALPHA CURSOR INDEX 


ACURSOR 


TD 


first-index 


1 





YES 




second-index 








YES 


SET BAUD RATES 


BAUDRATE 


NR 


transmit-data-rate 


2400 


error NR11 


YES 




receive-data-rate 


2400 


error NR21 


YES 


SET BREAK TIME 


BREAKTIME 


NK 


break-time 


200 





YES 


SET BYPASS CANCEL CHARACTER 


BYPASSCANCEL 


NU 


bypass-cancel-character 


L F 


N u 


YES 


SET CHARACTER PATH 


GTPATH 


MN 


direction 










SET DIALOG AREA BUFFER 


DABUFFER 


LB 


number-of-lines 


49 


error LB11 


YES 


SET DIALOG AREA COLOR MAP 


DACMAP 


TF 


color-mixture 


= black 

1 = white 

2 = red 

3 = green 

4 = blue 

5 = cyan 

6 = magenta 

7 = yellow 


empty array 


YES 


SET DIALOG AREA INDEX 


DAINDEX 


LI 


character-index 


1 





YES 




char-background-index 








YES 




dialog-background-index 








YES 


SET DIALOG AREA LINES 


DALINES 


LL 


number-of-lines 


30 


error LL1 1 


YES 


SET DIALOG AREA VISIBILITY 


DAVISIBILITY 


LV 


visibility-mode 


1 


1 


YES 


SET DIALOG AREA WRITING MODE 


DAMODE 


LM 


writing-mode 








YES 


SET ECHO 


ECHO 


KE 


echo-mode 





1 


YES 


SET EDIT CHARS 


EDITCHARS 


KZ 


character-delete 


D L 


unchanged 


YES 




line-delete 


C N 


unchanged 


YES 




take-literally 


~ 


unchanged 


YES 


SET EOF STRING 


EOFSTRING 


NE 


end-of-file-string 


empty array 


empty array 


YES 


SET EOL STRING 


EOLSTRING 


NT 


end-of-line-string 


C R 


empty array 


YES 


SET EOM CHARACTERS 


EOMCHARS 


NC 


first-eom-character 


C R 


N u 


YES 




second-eom-character 


N U 


N u 


YES 


SET ERROR THRESHOLD 


ERRORLEVEL 


KT 


error-threshold-level 


2 







SET FLAGGING MODE 


FLAGGING 


NF 


flagging-mode 








YES 
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Table D-1 (cont) 
4100-STYLE PARAMETER DEFAULTS 





Setup Name 


Host 
Op-Code 


Parameters 


Defaults 


Saved In 
Nonvolatile 


Descriptive Name 


Factory 


Omitted 


Memory 


SET GIN CURSOR COLOR 


GCURSOR 


TC 


hue 








YES 




lightness 


100 





YES 




saturation 


Q 


n 


YES 


SET GRAPHICS AREA WRITING 
MODE 


GAMODE 


MG 


writing-mode 


1 







SET GRAPHTEXT ROTATION 




MR 


angle 


0,0 


0,0 




SET GRAPHTEXT SIZE 


GTSIZE 


MC 


height 


61 






SET KEY EXECUTE CHARACTER 


KEYEXCHAR 


KY 


key-execute-character 


D L 


N u 


YES 


SET LINE INDEX 


LINEINDEX 


ML 


line-index 


1 







SET LINE STYLE 


LINESTYLE 


MV 


line-style 










SET MARKER TYPE 


MARKERTYPE 


MM 


marker-number 










SET PARITY 


PARITY 


NP 


parity-mode 








YES 


SET PROMPT STRING 


PROMPTSTRING 


NS 


prompt-string 


empty array 


empty array 


YES 


SET QUEUE SIZE 


QUEUESIZE 


NQ 


queue-size 


300 


error NQ11 


YES 


SET SNOOPY MODE 


SNOOPY 


KS 


snoopy-mode 





1 




SET STOP BITS 


STOPBITS 


NB 


number-of-stopbits 


1 


error NB11 


YES 


SET SURFACE COLOR MAP 


CMAP 


TG 


surface-number 


1 


error TG 11 


YES 




color-mixture 


= black 

1 = white 

2 = red 

3 = green 

4 = biue 

5 = cyan 

6 = magenta 

7 = yellow 


empty array 


YES 


SET TAB STOPS 


TABS 


KB 


tab-stops 


1,9,17,19, 
33, 41 , 49, 
57, 65, 73 




YES 


SET TEXT INDEX 


GTINDEX 


MT 


text-index 


1 







SET TRANSMIT DELAY 


XMTDELAY 


ND 


transm it-delay 


100 





YES 


SET TRANSMIT RATE LIMIT 


XMTLIMIT 


NL 


rate-limit 


19200 


error NL11 


YES 


SET VIEW ATTRIBUTES 


VIEWATTRIBUTES 


RA 


surface 


1 


error RA1 1 






background-index 





error RA21 




SET WINDOW 


WINDOW 


RW 


lower-left-corner 


0,0 


0,0 


YES 




upper-right-corner 


4095,3132 


4095,3132 


YES 


SET 4010 LINE STYLE 




code 


line-style-code 


solid 
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Table D-2 
ANSI-STYLE COMMAND PARAMETER 





Setup Name 


Host 
Op-Code 


Parameters 


Defaults 


Saved In 
Nonvolatile 


Descriptive Name 


Factory 


Omitted 


Memory 


CBT 




Z 


number-of-tab-stops 








CHT 




1 


number-of-tab-stops 








CUB 




D 


number-of-columns 








CUD 




B 


number-of-lines 








CUF 




C 


number-of-columns 








CUP 




H 


row-number 










column-number 








CUU 




A 


number-of-lines 








DCH 




P 


number-of-characters 








DSR 




n 






error [n 11 




DL 




M 


number-of-lines 








ECH 




X 


number-of-characters 








ED 




J 


erase-extent 









EL 




K 


erase-extent 




G 




HVP 




f 


row-number 










column-number 








ICH 




@ 


number-of-characters 








IL 




L 


number-of-lines 








RM 
SCS 


SELECTCHARSET 


1 


modes 
character-set 








SD 




T 


number-of-lines 




1 




SELECT CODE 


CODE 


o/o! 


syntax 








YES 


SGR 


TEXTRENDITION 


m 


graphic-rendition 










SM 




h 


modes 








SU 




S 


number-of-lines 




1 




TBC 




g 


tab-clear-extent 









TEKSTBM 


EDITMARGINS 


r 


top-margin 


1 


1 






bottom-margin 


30 


1 
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Table D-3 
SETUP MODE ONLY COMMAND PARAMETER DEFAULTS 





Parameters 


Defaults 


Saved In 
Nonvolatile 


Setup Name 


Factory 


Omitted 


Memory 


AUTOREPEAT 


autorepeat-mode 


YES 




YES 


AUTOWRAP 


autowrap-mode 


YES 




YES 


CURSORKEYMODE 


pad-mode 


application 






DAMODE 


overstrike-replace-mode 


REPLACE 




YES 


HELP 


command-name 




all commands 




INSERTREPLACE 


insert-replace-mode 


REPLACE 






KEYPADMODE 


key-mode 


YES 






LOCAL 


local-mode 


NO 


YES 




MACROSTATUS 


macro-number 








ORIGINMODE 


origin-mode 


RELATIVE 




YES 
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GLOSSARY 



41 00 Commands 

The set of terminal commands not included in the ANSI 
command set. These commands include terminal control 
and graphics commands. 



ASCII Code 

American Standard Code for Information Interchange. Each 
transmitted character has a unique 7-bit plus parity bit code 
established by ANSI (in ANSI Standard X3.4). 



Absolute Origin Mode 

Refer to the Set Mode and Reset Mode commands in the 
Screen Editor Support section of this manual for more 
information. 



Baud 

A unit of signalling speed corresponding to one signal event 
per second. This is usually the rate, in bits per second, at 
which the terminal communicates with a host. 



Alpha Mode 

In this mode, the terminal interprets any received ASCII 
characters as text to be displayed. If the dialog area is en- 
abled, these characters are displayed in the dialog area; 
otherwise, the characters are displayed in the graphics 
area. 



ANSI 

The American National Standards Institute. This is the 
U.S. A member body of the International Standards 
Organization. 



Break 

The effect of sending a continuous stream of binary 0's for a 
specified time — usually interpreted by the host as an 
interrupt. 



Character Sets — Alternate 

The optional character sets that are available on the termi- 
nal. These sets include foreign language, rulings and spe- 
cial character sets. The SCS (Select Character Set) com- 
mand determines which of the optional sets are currently 
available. 



ANSI Command 

A set of standardized terminal control functions that allow 
the editing of computer files on the terminal screen. This set 
of commands is not included in the 4100 command set. 
These commands are specified in ANSI Standard X3.64 
and in ISO International Standard 6429. 



ANSI Mode 

The mode of operation in which the terminal can accept and 
execute the ANSI command set. In ANSI mode the terminal 
accepts the ANSI command syntax; in TEK mode, it accepts 
the 41 00 command syntax. 



Color Index 

An integer in the range through 7 that refers to a color. 
The color assigned to a color index can be defined by either 
the operator or the host program. The dialog area and the 
graphics area each have their own set of color indices. 



Color Interface 

An interactive program that lets the operator set the colors 
used in displays. The operator can change colors by choos- 
ing a color index or by choosing an item in the display. 
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Commands 

The terminal recognizes 4 different types of commands: 
ANSI, 4010, 4100, and Setup mode commands. Each type 
has its own syntax differences. Refer to the Screen Editor 
Support and 4100-Style Commands, Reports, and Parame- 
ter Types sections of this manual for more information. 



Dialog Buffer 

The to 49 lines of text stored in the terminal's memory of 
which up to 30 lines are visible at any one time. 



Echo 



Current Graphics Position 

Location on the screen where the last graphics operation 
ended. Same location is starting point for next graphics 
operation. 



When a key is pressed on the terminal, the character dis- 
played on the screen is the echo. This echo can be supplied 
either by the terminal or by the host. 



Edit Margins 



Cursor 

The movable screen marker that determines the screen lo- 
cation where commands will take effect. The Alpha cursor is 
an underscore that you can move with the cursor movement 
keys. The Graphics cursor is a crosshair cursor that you can 
move with the joydisk. 



The margins set in the dialog area that define a scrolling re- 
gion in which text editing is performed. 



Edit Mode 

A specific implementation of ANSI mode in which the termi- 
nal is configured to operate as a VT-1 00 terminal. 



Default 

The preset value that a parameter takes when a value is not 
supplied. 



Deleting 

The process of causing characters or lines and the space 
that they occupy to be removed from the display. 



Delimiter 



Erasing 

The process of causing characters or lines to be removed 
from the display while filling the space that they occupy with 
the erase index. 



Escape Sequence 

A series of characters preceded by an E c character — used 
to enter commands from the keyboard and from the host 
computer. 



A character that marks the beginning and end of a string of 
characters. The delimiter must not be contained in the de- 
limited string. 



Dialog Area 



Fixed Region 

A user definable region of the dialog buffer that cannot be 
scrolled — typically used for status line information in 
screen editor programs. 



The portion of the terminal's display in which text editing 
and host computer dialog take place. 



Graphic Rendition 

One of several styles in which text can be displayed in the 
dialog area. Choices include: Normal (default), Bold, Under- 
score, Slow Blink, and Reverse Video. 



E-2 



REV, SEP 1983 



4105 PROGRAMMERS 



GLOSSARY 



Graphics 

Information displayed pictorially as a series of lines and 
panels. 



Graphics Area 

The portion of the terminal's display that is used to display 
graphics information. 



Graphics Cursor 



Nonvolatile Memory 

The portion of terminal memory thai keeps information even 
when the terminal is turned off. Many terminal parameters 
can be saved in this portion of memory. 



Numeric Keypad 

The group of keys on the right side of the keyboard labled 
for numeric input; can also be programmed for use with ap- 
plication programs. 



The displayed crosshairs that the operator uses to select a 
location in the graphics area. 



Handshaking Protocol 

A formalized sequence of operations between the terminal 
and the host in which each take turns transmitting data. 



Home Position 



Output Queue 

The portion of the terminal's memory in which transmitted 
data is held until the host computer can process it. 



Paging 

The process of writing one screenful of text and then eras- 
ing the screen before more text is displayed. 



The position of the cursor after a Page command has been 
executed when the dialog area is disabled; terminal coordi- 
nates 0,3071 . 



Input Queue 

The portion of the terminal's memory in which incoming 
data is heid untii the terminal can process it. 



Inserting 

The process of adding new characters to the display by 
moving characters to the right of the cursor toward the right 
side of the screen (leaving a space) and displaying the new 
characters in that space. 



Joydisk 

Controls the position of the graphics cursor on the screen as 
well as scrolling text in the dialog area. 



Parameter Types 

A class of parameters that has a specific format. Some ex- 
amples of parameter types are integer array, delimited 
string, and xy-coordinate. 



Parity 

A simple form of error checking where a single bit is added 
to to a stream of bits so that the total number of bits is odd 
(odd parity) or even (even parity). 



Peripheral Device 

Auxiliary equipment of a computer system, usually perform- 
ing input-output functions, such as disk drives or printers. 



Pixel 

One picture element in the graphics area. The terminal's 
graphics area is 480 pixels wide by 360 pixels high. 
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Saved Parameters 

Terminal settings that remain in the terminal's memory 
even when the terminal is turned off. 



Shift Out 

A control character used to change from the GO character 
set to the G 1 character set. 



Setup Command 

A class of terminal command that is entered while in Setup 
mode. 



Screen Editor 

A text entry/editing program that displays a portion of a 
computer file on the screen of the terminal allowing you to 
change the text while viewing the changes. (As opposed to 
line editors which require line by line editing and redisplay 
of changed lines.) 



Screen 

The color picture tube on which the terminal's output is 
displayed. 



Software 

Computer programs. 

Stop Bit 

A bit, always a 1 , occurring at the end of a character. Used 
to hold the communication line in "mark" state until the re- 
ceiving device is ready for the next character. 



Surface 

A named group of display items. The items assigned to a 
surface can be manipulated as a group and displayed simu- 
taneously with other surfaces. The 4105 does not use sur- 
faces, but some commands permit a surface specification 
for compatibility with other Tektronix terminals. 



Scrolling 

The up or down movement of lines of text on the screen; as 
available lines of text appear at one end of the screen, other 
lines move off the screen at the opposite end. 



Scrolling Region 

A user definable region of the dialog area that can be 
scrolled — typically used for displaying the portion of the file 
being edited by a screen editor program. 



Self Test 

A program stored in the terminal's firmware that tests termi- 
nal functions and displays any errors it encounters. There 
are three types of self test: power-up, extended, and adjust- 
ment. See the 4105 Operators Manual for more information. 



TEK Mode 

The mode of operation in which the terminal can accept and 
execute the command set used in TEKTRONIX 4100 Series 
Terminals. In TEK mode the terminal accepts the 41 00 com- 
mand syntax; in ANSI mode, it accepts the ANSI command 
syntax. 



Terminal Initialization File 

The file required by many host computers to configure the 
terminal's operating characteristics. 



Terminal Report 

A report sent by the terminal to the host computer — usually 
contains some form of status information. 



Shift In 

A control character used to change from the G1 character 
set to the GO character set. 
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100% -r 



In the HLS color coordinate system, 
the color space is represented as a 
double-ended cone. 

The HUE coordinate runs 
counterclockwise around the 
cone. (0 to 360 degrees 

The LIGHTNESS coordinate runs 
vertically up the cone. (0% to 100%.) 

The SATURATION coordinate runs 
radially outward from the axis of 
the cone. The SATURATION coordinate 
is a percentage of the maximum 
possible saturation at a particular iso° 
LIGHTNESS level. (0% to 100%.) 



120° 60° 

A*^X 




0° Blue 



111 



X 



340° 



_ , (continued) 
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TEKTRONIX 

COLOR 

STANDARD 



Overview: 

The world of color is filled with ambiguous 
terminology, i.e. intensity, purity, value, etc. 
Many color users feel that "color theory" is a 
prerequisite to operating color systems; T.V., 
Videotaping, Photography, Computer Graph- 
ics. 

In order to end this confusion, Tektronix has 
developed a color language and function 
based on human engineering, rather than 
machine engineering. Below is a description 
of this system, which will provide a clear 
and concise means for understanding how 
color is defined and how our syntax was 
derived. 

Color Concepts: 

Color selection is specified by hue, light- 
ness and saturation which is the HLS 
method. The definitions are as follows: 



Saturation: The characteristic which 

describes the extent to 
which a color differs from 
a gray of the same light- 
ness. Saturation is ex- 
pressed as percentage, 
ranging from 0% (maxi- 
mum white content at that 
lightness level) to 100% 
(full saturated). 

Geometrically, colors can be described in 
terms of a double cone. 
Variations in lightness are represented 
along the axis, with white at the apex of 
the cone and black at the opposite apex. 
Variations in saturation are represented by 
radial distances from the lightness axis, in 
constant lightness planes. Hue is repre- 
sented as an angular quantity from a known 
reference point. 



Hue: 



Lightness: 



The characteristic associ- 
ated with a color name 
such as red, yellow, green, 
blue, etc. Hue is a grada- 
tion of color advanced by 
degrees, thus represented 
as an angle from to 360. 

The characteristic that al- 
lows the color to be 
ranked on a scale from 
dark to light. Lightness is 
expressed as a parameter 
ranging from to 100% 
with black being (bot- 
tom of cone) and white 
being 1 00% (top of cone). 



Copyright © 1982 by Tektronix, Inc., Beaverton, Oregon. 
Printed in the United States of America. All rights reserved. 
Contents of this publication may not be reproduced in any form 
without permission of Tektronix, Inc. U.S.A. and foreign TEK- 
TRONIX products covered by U.S. and foreign patents and/or 
patents pending. 

TEKTRONIX is a registered trademark for Tektronix, Inc. 
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EXAMPLES OF INTEGER PARAMETERS 



Table G-1 lists integer parameters between -1049 and +1049. 



Table G-1 
INTEGER PARAMETERS 



+ lnf 


Pa ram 


-lnt b 


Param 








-0 


s p 


1 


1 


-1 


1 


2 


2 


_2 


J) 


3 


3 


-3 


# 


4 


4 


-4 


$ 


5 


5 


-5 


% 


6 


6 


-6 


& 


7 


7 


-7 


J 


8 


8 


-8 


( 


9 


9 


-9 


) 


10 




-10 


* 


11 


1 


-11 


+ 


12 


< 


-12 


J 


13 


— 


-13 


- 


14 


> 


-14 


. 


15 


? 


-15 


/ 


16 


A0 


-16 


A s p 


17 


A1 


-17 


A! 


18 


A2 


-18 


A" 


19 


A3 


-19 


A# 


20 


A4 


-20 


A$ 


21 


A5 


-21 


A% 


22 


A6 


-22 


A& 


23 


A7 


-23 


A' 


24 


A8 


-24 


A( 


25 


A9 


25 


A) 


26 


A: 


-26 


A* 


27 


A; 


-27 


A + 


28 


A< 


-28 


A, 


29 


A = 


-29 


A- 


30 


A> 


-30 


A. 


31 


A? 


-31 


A/ 


32 


BO 


-32 


B s p 


33 


B1 


-33 


B! 


34 


B2 


-34 


B" 


35 


B3 


-35 


B# 


36 


B4 


-36 


BS 


37 


B5 


-37 


B% 


38 


B6 


-38 


B& 


39 


B7 


-39 


B' 


40 


B8 


-40 


B( 


41 


B9 


-41 


B) 


42 


B: 


-42 


B* 


43 


B; 


-43 


B+ 


44 


B< 


-44 


B, 


45 


B= 


-45 


B- 


46 


B> 


-46 


B. 


47 


B? 


-47 


B/ 


48 


CO 


-48 


C S P 


49 


C1 


-49 


C! 



+ lnf 


Param 


-Int" 


Param 


50 


C2 


-50 


C" 


51 


C3 


-51 


C# 


52 


C4 


-52 


c$ 


53 


C5 


-53 


c% 


54 


C6 


-54 


c& 


55 


C7 


-55 


c 


56 


C8 


-56 


C( 


57 


C9 


-57 


C) 


58 


C: 


-58 


c* 


59 


C; 


-59 


c+ 


60 


C< 


-60 


c, 


61 


C= 


-61 


c- 


62 


C> 


-62 


c. 


63 


C? 


-63 


c/ 


64 


DO 


-64 


D s p 


65 


D1 


-65 


D! 


66 


D2 


-66 


D" 


67 


D3 


-67 


D# 


68 


D4 


-68 


D$ 


69 


D5 


-69 


D% 


70 


D6 


-70 


D& 


71 


D7 


-71 


D' 


72 


D8 


-72 


D( 


73 


D9 


73 


D) 


74 


D: 


-74 


D* 


75 


D; 


-75 


D + 


76 


D< 


-76 


D, 


77 


D= 


-77 


D- 


78 


D> 


-78 


D. 


79 


D? 


-79 


D/ 


80 


EO 


-80 


E s p 


81 


E1 


-81 


E! 


82 


E2 


-82 


E" 


83 


E3 


-83 


E# 


84 


E4 


-84 


E$ 


85 


E5 


-85 


E% 


86 


E6 


-86 


E& 


87 


E7 


-87 


E' 


88 


E8 


-88 


E( 


89 


E9 


-89 


E) 


90 


E: 


-90 


E* 


91 


E; 


-91 


E + 


92 


E< 


-92 


E, 


93 


E = 


-93 


E- 


94 


E> 


-94 


E. 


95 


E? 


-95 


E/ 


96 


FO 


-96 


F S P 


97 


F1 


-97 


F! 


98 


F2 


-98 


F" 


99 


F3 


-99 


F# 



+ lnf 


Param 


-Inf 


Param 


100 


F4 


-100 


F$ 


101 


F5 


-101 


F% 


102 


F6 


-102 


F& 


103 


F7 


-103 


F' 


104 


F8 


-104 


F( 


105 


F9 


-105 


F) 


106 


F: 


-106 


F* 


107 


F; 


-107 


F + 


108 


F< 


-108 


F, 


109 


F= 


-109 


F- 


110 


F> 


-110 


F. 


111 


F? 


-111 


F/ 


112 


GO 


-112 


G S P 


113 


G1 


-113 


G! 


114 


G2 


-114 


G" 


115 


G3 


-115 


G# 


116 


G4 


-116 


G$ 


117 


G5 


-117 


G% 


118 


G6 


-118 


G& 


119 


G7 


-119 


G' 


120 


G8 


-120 


G( 


121 


G9 


-121 


G) 


122 


G: 


-122 


G* 


123 


G; 


-123 


G+ 


124 


G< 


-124 


G, 


125 


G = 


-125 


G- 


126 


G> 


-126 


G. 


127 


G? 


-127 


G/ 


128 


HO 


-128 


H s p 


129 


H1 


-129 


H! 


130 


H2 


-130 


H" 


131 


H3 


-131 


H# 


132 


H4 


-132 


HS 


133 


H5 


-133 


H% 


134 


H6 


-134 


H& 


135 


H7 


-135 


H' 


136 


H8 


-136 


H( 


137 


H9 


-137 


H) 


138 


H: 


-138 


H* 


139 


H; 


-139 


H + 


140 


H< 


-140 


H, 


141 


H = 


-141 


H- 


142 


H> 


-142 


H. 


143 


H? 


-143 


H/ 


144 


10 


-144 


l s P 


145 


11 


-145 


1! 


146 


12 


-146 


1" 


147 


13 


-147 


l# 


148 


14 


-148 


1$ 


149 


15 


-149 


1% 



Positive integer 
Negative integer 



For integers ± 144 through ± 159, the first char- 
acter of the parameter is an uppercase I (A DE 73). 



4105 PROGRAMMERS 



REV, SEP 1983 



G-1 



INTEGER PARAMETERS 



+ lnf 


Param 


-lnt b 


Param 


150 


16 


-150 


l& 


151 


17 


-151 


19 


152 


18 


-152 


K 


153 


19 


-153 


1) 


154 


1: 


-154 


1* 


155 


l; 


-155 


1 + 


156 


l< 


-156 


1, 


157 


l= 


-157 


1- 


158 


l> 


-158 


1. 


159 


l? 


-159 


1/ 


160 


JO 


-160 


J S P 


161 


J1 


-161 


J! 


162 


J2 


-162 


J" 


163 


J3 


-163 


J# 


164 


J4 


-164 


J$ 


165 


J5 


-165 


J% 


166 


J6 


-166 


J& 


167 


J7 


-167 


J' 


168 


J8 


-168 


J( 


169 


J9 


-169 


J) 


170 


J: 


-170 


J* 


171 


J; 


-171 


J + 


172 


J< 


„ 17 2 


J, 


173 


J = 


-173 


J- 


174 


J> 


-174 


J. 


175 


J? 


-175 


J/ 


176 


KO 


-176 


K s p 


177 


K1 


-177 


K! 


178 


K2 


-178 


K" 


179 


K3 


-179 


K# 


180 


K4 


-180 


K$ 


181 


K5 


-181 


K% 


182 


K6 


-182 


K& 


183 


K7 


-183 


K' 


184 


K8 


-184 


K( 


185 


K9 


-185 


K) 


186 


K: 


-186 


K* 


187 


K; 


-187 


K + 


188 


K< 


-188 


K, 


189 


K = 


-189 


K- 


190 


K> 


-190 


K. 


191 


K? 


-191 


K/ 


192 


LO 


-192 


L S P 


193 


L1 


-193 


L! 


194 


L2 


-194 


L" 


195 


L3 


-195 


L# 


196 


L4 


-196 


L$ 


197 


L5 


-197 


L% 


198 


L6 


-198 


L& 


199 


L7 


-199 


L' 



Table G-1 (cont) 
INTEGER PARAMETERS 



+ lnf 


Param 


-Int" 


Param 


200 


L8 


-200 


M 


201 


L9 


-201 


L) 


202 


L: 


-202 


L* 


203 


L; 


-203 


L + 


204 


L< 


-204 


L, 


205 


L= 


-205 


L- 


206 


L> 


-206 


L. 


207 


L? 


-207 


u 


208 


MO 


-208 


M s p 


209 


M1 


-209 


M! 


210 


M2 


-210 


M" 


211 


M3 


-211 


M# 


212 


M4 


-212 


M$ 


213 


M5 


-213 


M% 


214 


M6 


-214 


M& 


215 


M7 


-215 


M' 


216 


M8 


-216 


M( 


217 


M9 


-217 


M) 


218 


M: 


-218 


M* 


219 


M; 


-219 


M + 


220 


M< 


-220 


M, 


221 


M = 


-221 


M- 


222 


M> 


-222 


M. 


223 


M? 


-223 


Ml 


224 


NO 


-224 


N s p 


225 


N1 


-225 


N! 


226 


N2 


-226 


N" 


227 


N3 


-227 


N# 


228 


N4 


-228 


N$ 


229 


N5 


-229 


N% 


230 


N6 


-230 


N& 


231 


N7 


-231 


N' 


232 


N8 


-232 


N( 


233 


N9 


-233 


N) 


234 


N: 


-234 


N* 


235 


N; 


-235 


N + 


236 


N< 


-236 


N, 


237 


N = 


-237 


N- 


238 


N> 


-238 


N. 


239 


N? 


-239 


N/ 


240 


00 


-240 


S P 


241 


01 


-241 


O! 


242 


02 


-242 


0" 


243 


03 


-243 


0# 


244 


04 


-244 


0$ 


245 


05 


-245 


0% 


246 


06 


-246 


0& 


247 


07 


-247 


0' 


248 


08 


-248 


0( 


249 


09 


-249 


0) 



+ lnt* 


Param 


-lnt b 


Param 


250 


0: 


-250 


0* 


251 


0; 


-251 


o+ 


252 


o< 


-252 


o, 


253 


0= 


-253 


0- 


254 


0> 


-254 


0. 


255 


0? 


-255 


0/ 


256 


PO 


-256 


pS p 


257 


P1 


-257 


P! 


258 


P2 


-258 


P" 


259 


P3 


-259 


P# 


260 


P4 


-260 


p$ 


261 


P5 


-261 


P% 


262 


P6 


-262 


P& 


263 


P7 


-263 


P' 


264 


P8 


-264 


P( 


265 


P9 


-265 


P) 


266 


P: 


-266 


P* 


267 


P; 


-267 


P + 


268 


P< 


-268 


P, 


269 


p= 


-269 


P- 


270 


p> 


-270 


P. 


271 


p? 


-271 


PI 


272 


QO 


-272 


QSp 


273 


Q1 


-273 


Q! 


274 


Q2 


-274 


Q" 


275 


Q3 


-275 


Q# 


276 


Q4 


-276 


QS 


277 


Q5 


-277 


Q% 


278 


Q6 


-278 


Q& 


279 


Q7 


-279 


Q' 


280 


Q8 


-280 


Q( 


281 


Q9 


-281 


Q) 


282 


Q: 


-282 


Q* 


283 


Q; 


-283 


Q+ 


284 


Q< 


-284 


Q, 


285 


Q= 


-285 


Q- 


286 


Q> 


-286 


Q. 


287 


Q? 


287 


Q/ 


288 


RO 


-288 


R s p 


289 


R1 


-289 


R! 


290 


R2 


-290 


R" 


291 


R3 


-291 


R# 


292 


R4 


-292 


RS 


293 


R5 


-293 


R% 


294 


R6 


-294 


R& 


295 


R7 


-295 


R' 


296 


R8 


-296 


R( 


297 


R9 


-297 


R) 


298 


R: 


-298 


R* 


299 


R; 


-299 


R + 



Positive integer 
b 
Negative integer 

For integers ±144 through ±159, the first char- 
acter of the parameter is an uppercase I (A DE 73). 



G-2 



REV, SEP 1983 



4105 PROGRAMMERS 



INTEGER PARAMETERS 



+ lnf 


Param 


-Int" 


Param 


300 


R< 


-300 


R, 


301 


R= 


-301 


R- 


302 


R> 


-302 


R. 


303 


R? 


-303 


R/ 


304 


SO 


-304 


S S P 


305 


S1 


-305 


S! 


306 


S2 


-306 


S" 


307 


S3 


— 307 


S# 


308 


S4 


-308 


ss 


309 


S5 


-309 


s% 


310 


S6 


-310 


s& 


311 


S7 


-311 


S' 


312 


S8 


-312 


S( 


313 


S9 


-313 


S) 


314 


S: 


-314 


s* 


315 


S; 


-315 


s+ 


316 


S< 


-316 


s, 


317 


S= 


-317 


s- 


318 


S> 


-318 


s. 


319 


S? 


-319 


si 


320 


TO 


-320 


T s p 


321 


T1 


-321 


T! 


322 


T2 


-322 


T" 


323 


T3 


-323 


T# 


324 


T4 


-324 


T$ 


325 


T5 


-325 


T% 


326 


T6 


-326 


T& 


327 


T7 


-327 


r 


328 


T8 


-328 


T( 


329 


T9 


-329 


T) 


330 


T: 


-330 


T* 


331 


T; 


-331 


T + 


332 


T< 


-332 


T, 


333 


T= 


-333 


T- 


334 


T> 


-334 


T. 


335 


T? 


-335 


T/ 


336 


UO 


-336 


U S P 


337 


U1 


-337 


U! 


338 


U2 


-338 


U" 


339 


U3 


-339 


u# 


340 


U4 


-340 


us 


341 


U5 


-341 


u% 


342 


U6 


-342 


u& 


343 


U7 


-343 


U' 


344 


U8 


-344 


U( 


345 


U9 


-345 


U) 


346 


U: 


-346 


u* 


347 


U; 


-347 


u+ 


348 


U< 


-348 


u, 


349 


U = 


-349 


u- 



Table G-1 (cont) 
INTEGER PARAMETERS 



+ lnf 


Param 


-Int" 


Param 


350 


U> 


-350 


U. 


351 


U? 


-351 


U/ 


352 


VO 


352 


v s p 


353 


V1 


-353 


V! 


354 


V2 


-354 


V" 


355 


V3 


-355 


V# 


356 


V4 


-356 


V$ 


nc7 
OOl 


up 

V3 


-357 


V% 


358 


V6 


-358 


v& 


359 


V7 


-359 


V 


360 


V8 


-360 


V( 


361 


V9 


-361 


V) 


362 


V: 


-362 


V* 


363 


V; 


-363 


v+ 


364 


V< 


-364 


v, 


365 


V= 


-365 


v- 


366 


V> 


-366 


V. 


367 


V? 


-367 


v/ 


368 


WO 


368 


w s p 


369 


W1 


-369 


W! 


370 


W2 


-370 


W" 


371 


W3 


-371 


w# 


372 


W4 


-372 


w$ 


373 


W5 


-373 


w% 


374 


W6 


-374 


w& 


375 


W7 


-375 


w 


376 


W8 


-376 


W( 


377 


W9 


-377 


W) 


378 


W: 


-378 


w* 


379 


W; 


-379 


w+ 


380 


W< 


-380 


w, 


381 


W = 


381 


w- 


382 


W> 


-382 


w. 


383 


W? 


383 


w/ 


384 


XO 


-384 


X s p 


385 


X1 


-385 


X! 


386 


X2 


-386 


X" 


387 


X3 


-387 


x# 


388 


X4 


-388 


xs 


389 


X5 


-389 


x% 


390 


X6 


-390 


x& 


391 


X7 


-391 


X' 


392 


X8 


-392 


X( 


393 


X9 


-393 


X) 


394 


X: 


-394 


X* 


395 


X; 


-395 


x+ 


396 


X< 


-396 


x, 


397 


X= 


-397 


X- 


398 


X> 


-398 


X. 


399 


X? 


-399 


x/ 



+ lnf 


Param 


-Int" 


Param 


400 


YO 


-400 


Y s p 


401 


Y1 


-401 


Y! 


402 


Y2 


-402 


Y" 


403 


Y3 


-403 


Y# 


404 


Y4 


-404 


Y$ 


405 


Y5 


-405 


Y% 


406 


Y6 


-406 


Y& 




Y7 


ACT? 


\I1 


408 


Y8 


-408 


Y( 


409 


Y9 


-409 


Y) 


410 


Y: 


-410 


Y* 


411 


Y; 


-411 


Y + 


412 


Y< 


-412 


Y, 


413 


Y = 


-413 


Y- 


414 


Y> 


-414 


Y. 


415 


Y? 


-415 


Y/ 


416 


ZO 


-416 


Z s p 


417 


Z1 


-417 


Z! 


418 


Z2 


-418 


Z" 


419 


Z3 


-419 


Z# 


420 


Z4 


-420 


z$ 


421 


Z5 


-421 


z% 


422 


Z6 


-422 


z& 


423 


Z7 


-423 


Z' 


424 


Z8 


-424 


Z( 


425 


Z9 


-425 


Z) 


426 


Z: 


-426 


z* 


427 


Z; 


-427 


z+ 


428 


Z< 


-428 


z, 


429 


z= 


-429 


z- 


430 


z> 


-430 


z. 


431 


z? 


-431 


z/ 


432 


[0 


-432 


[•p 


433 


[1 


-433 


[! 


434 


[2 


-434 


[" 


435 


f3 


-435 


[# 


436 


[4 


-436 


[S 


437 


[5 


-437 


[% 


438 


[6 


-438 


[& 


439 


[7 


-439 


[' 


440 


[8 


-440 


[( 


441 


[9 


-441 


[) 


442 


[: 


-442 


[* 


443 


[; 


-443 


[+ 


444 


[< 


-444 


[. 


445 


[ = 


-445 


[- 


446 


[> 


-446 


[■ 


447 


[? 


-447 


[/ 


448 


\o 


-448 


\ S P 


449 


\1 


-449 


\! 



Positive integer 
Negative integer 



4105 PROGRAMMERS 



REV, SEP 1983 



G-3 



INTEGER PARAMETERS 



+ lnf 


Param 


-Int" 


Param 


450 


\2 


-450 


\" 


451 


\3 


-451 


\# 


452 


\4 


-452 


\$ 


453 


\5 


-453 


\% 


454 


\6 


-454 


\& 


455 


\7 


-455 


V 


456 


\8 


-456 


\( 


457 


\9 


-457 


\) 


458 


\: 


-458 


\* 


459 


\; 


-459 


\+ 


460 


\< 


-460 


\, 


461 


\= 


-461 


\- 


462 


\> 


-462 


V 


463 


\? 


-463 


V 


464 


]0 


-464 


] S P 


465 


J1 


-465 


]! 


466 


]2 


-466 


]" 


467 


J3 


-467 


]# 


468 


]4 


-468 


]$ 


469 


J5 


-469 


]% 


470 


J6 


-470 


]& 


471 


V 


-471 


]' 


472 


IB 


-472 


1( 


473 


J9 


-473 


]) 


474 


J: 


-474 


]* 


475 


]; 


-475 


1 + 


476 


]< 


-476 


]. 


477 


] = 


-477 


]- 


478 


]> 


-478 


]■ 


479 


]? 


-479 


]/ 


480 


A0 


-480 


A S P 


481 


A1 


-481 


A! 


482 


A2 


-482 


A" 


483 


A3 


-483 


A# 


484 


A4 


-484 


A$ 


485 


A5 


-485 


A% 


486 


A6 


-486 


A& 


487 


A7 


-487 


A' 


488 


A8 


-488 


A( 


489 


A9 


-489 


A) 


490 


A: 


-490 


A* 


491 


A; 


-491 


A + 


492 


A< 


-492 


A, 


493 


A = 


-493 


A- 


494 


A> 


-494 


A. 


495 


A? 


-495 


A/ 


496 


_0 


-496 


_ S P 


497 


_1 


-497 


_J 


498 


_2 


-498 


1» 


499 


_3 


-499 


_# 



Table G-1 (cont) 
INTEGER PARAMETERS 



+ lnt a 


Param 


-Int" 


Param 


500 


_4 


-500 


_$ 


501 


5 


-501 


_% 


502 


_6 


-502 


„& 


503 


_7 


-503 


J 


504 


_8 


-504 


-( 


505 


_9 


-505 


-) 


506 


_: 


-506 


* 


507 


_; 


-507 


_+ 


508 


_< 


-508 


— , 


509 


_= 


-509 


_- 


510 


_> 


-510 


_. 


511 


_•> 


-511 


_/ 


512 


'0 


-512 


■s p 


513 


'1 


-513 


<| 


514 


'2 


-514 


tn 


515 


'3 


-515 


'# 


516 


'4 


-516 


'$ 


517 


'5 


-517 


'% 


518 


'6 


-518 


'& 


519 


•7 


-519 


t> 


520 


'8 


-520 


'( 


521 


'9 


-521 


') 


522 


': 


-522 


(* 


523 


i. 


-523 


'"'+' 


524 


'< 


-524 


t 


525 


' = 


-525 


i 


526 


'> 


-526 


( 


527 


'? 


-527 


'/ 


528 


a0 


-528 


a s p 


529 


a1 


-529 


a! 


530 


a2 


-530 


a" 


531 


a3 


-531 


a# 


532 


a4 


-532 


aS 


533 


a5 


-533 


a% 


534 


a6 


-534 


a& 


535 


a7 


-535 


a' 


536 


a8 


-536 


a( 


537 


a9 


-537 


a) 


538 


a: 


538 


a* 


539 


a; 


-539 


a + 


540 


a< 


-540 


a, 


541 


a= 


-541 


a — 


542 


a> 


-542 


a. 


543 


a? 


-543 


a/ 


544 


bO 


-544 


b s p 


545 


b1 


-545 


b! 


546 


b2 


-546 


b" 


547 


b3 


-547 


b# 


548 


b4 


-548 


bS 


549 


b5 


-549 


b% 



+ lnf 


Param 


-Int" 


Param 


550 


b6 


-550 


b& 


551 


b7 


-551 


b' 


552 


b8 


552 


b( 


553 


b9 


-553 


b) 


554 


b: 


-554 


b* 


555 


b; 


-555 


b+ 


556 


b< 


-556 


b, 


557 


b= 


-557 


b- 


558 


b> 


-558 


b. 


559 


b? 


-559 


b/ 


560 


cO 


-560 


C S P 


561 


d 


-561 


c! 


562 


c2 


-562 


c" 


563 


c3 


-563 


c# 


564 


c4 


-564 


c$ 


565 


c5 


-565 


c% 


566 


c6 


-566 


c& 


567 


c7 


-567 


C 


568 


c8 


568 


c( 


569 


c9 


-569 


c) 


570 


c: 


-570 


c* 


571 


c; 


-571 


c + 


572 


c< 


-572 


c, 


573 


c= 


-573 


c— 


574 


c> 


-574 


c. 


575 


c? 


-575 


c/ 


576 


dO 


-576 


d s p 


577 


d1 


-577 


d! 


578 


d2 


-578 


d" 


579 


d3 


-579 


d# 


580 


d4 


-580 


dS 


581 


d5 


-581 


d% 


582 


d6 


-582 


d& 


583 


d7 


-583 


d' 


584 


d8 


-584 


d( 


585 


d9 


-585 


d) 


586 


d: 


-586 


d* 


587 


d; 


-587 


d + 


588 


d< 


-588 


d, 


589 


d= 


-589 


d- 


590 


d> 


-590 


d. 


591 


d? 


-591 


d/ 


592 


eO 


-592 


e s p 


593 


e1 


-593 


e! 


594 


e2 


-594 


e" 


595 


e3 


-595 


e# 


596 


e4 


-596 


e$ 


597 


e5 


-597 


e% 


598 


e6 


-598 


e& 


599 


e7 


-599 


e' 



Positive integer 
Negative integer 



G-4 



REV, SEP 1983 
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INTEGER PARAMETERS 



Table G-1 (cont) 
INTEGER PARAMETERS 



+ lnt a 


Param 


-lnt b 


Param 


600 


e8 


-600 


e( 


601 


e9 


-601 


e) 


602 


e: 


-602 


e* 


603 


e; 


-603 


e+ 


604 


e< 


-604 


e, 


605 


e= 


-605 


e— 


606 


e> 


-606 


e. 


607 


e? 


-607 


el 


608 


fO 


-608 


f s p 


609 


f1 


-609 


f! 


610 


f2 


-610 


f" 


611 


f3 


-611 


f# 


612 


f4 


-612 


f$ 


613 


f5 


-613 


f% 


614 


f6 


-614 


f& 


615 


f7 


-615 


f 


616 


f8 


-616 


f( 


617 


f9 


-617 


f) 


618 


f: 


-618 


f* 


619 


f; 


-619 


f+ 


620 


f< 


-620 


f, 


621 


f= 


-621 


f- 


622 


f> 


-622 


f, 


623 


f? 


-623 


f/ 


624 


g0 


-624 


g s p 


625 


gi 


-625 


g! 


626 


g2 


-626 


g" 


627 


g3 


-627 


g# 


628 


g4 


628 


g$ 


629 


gs 


-629 


g% 


630 


ge 


-630 


g& 


631 


g 7 


-631 


g' 


632 


gs 


-632 


g( 


633 


g9 


-633 


g) 


634 


g: 


-634 


g* 


635 


g; 


-635 


g+ 


636 


g< 


-636 


g. 


637 


g= 


-637 


g- 


638 


g> 


-638 


9- 


639 


g? 


-639 


g/ 


640 


h0 


-640 


h s p 


641 


hi 


-641 


h! 


642 


h2 


-642 


h" 


643 


h3 


-643 


h# 


644 


h4 


-644 


h$ 


645 


h5 


-645 


h% 


646 


h6 


-646 


h& 


647 


h7 


-647 


h' 


648 


h8 


-648 


h( 


649 


h9 


-649 


h) 



+ lnf 


s aram 


-lnt b 


Param 


650 


h: 


-650 


h* 


651 


h; 


-651 


h + 


652 


h< 


-652 


h, 


653 


h= 


-653 


hi- 


654 


h> 


-654 


ll. 


655 


h? 


-655 


h/ 


656 





-656 


i s P 


657 


■ 


-657 


if 


658 


2 


-658 


i" 


659 


3 


-659 


i# 


660 


4 


-660 


IS 


661 


5 


-661 


i% 


662 


6 


-662 


i& 


663 


7 


-663 


jj 


664 


8 


-664 


i( 


665 


9 


-665 


i) 


666 




-666 


i* 


667 


; 


-667 


i+ 


668 


< 


-668 


"j 


669 


= 


-669 


i- 


670 


> 


-670 




671 


? 


-671 


i/ 


672 





-672 


j s p 


673 


1 


-673 


j! 


674 


2 


-674 


i" 


675 


3 


-675 


i# 


676 


4 


-676 


is 


677 


5 


-677 


j% 


678 


6 


-678 


j& 


679 


7 


-679 


:) 


680 


8 


-680 


j( 


681 


9 


681 


j) 


682 


: 


-682 


i* 


683 


s 


-683 


)+ 


684 


< 


-684 


ji 


685 


= 


-685 


j- 


686 j 


> 


-686 




687 


? 


-687 


i/ 


688 


kO 


-688 


k s p 


689 


k1 


-689 


k! 


690 


<2 


-690 


k" 


691 


<3 


-691 


k# 


692 


<4 


-692 


kS 


693 


<5 


693 


k% 


694 


k6 


-694 


k& 


695 


a 


-695 


k' 


696 


<8 


-696 


k( 


697 


<9 


-697 


k) 


698 


<: 


-698 


k* 


699 


<; 


-699 


k+ 



+ lnt a 


Param 


-lnt b 


Param 


700 


k< 


-700 


k, 


701 


k= 


-701 


k- 


702 


k> 


-702 


k. 


703 


k? 


-703 


k/ 


704 


10 


-704 


I s p 


705 


11 


-705 


I! 


706 


12 


-706 


1" 


707 


19 
i<9 


-707 


144- 

■ 7T 


708 


14 


-708 


\$ 


709 


15 


-709 


1% 


710 


16 


-710 


l& 


711 


17 


-711 


IT 


712 


18 


-712 


K 


713 


19 


-713 


1) 


714 


1: 


-714 


1* 


715 


I; 


-715 


1+ 


716 


l< 


-716 


'» 


717 


1 = 


-717 


i— 


718 


l> 


-718 


i. 


719 


1? 


-719 


1/ 


720 


mO 


-720 


m s p 


721 


ml 


-721 


m! 


722 


m2 


-722 


m" 


723 


m3 


-723 


m# 


724 


m4 


-724 


m$ 


725 


m5 


-725 


m% 


726 


m6 


-726 


m& 


727 


m7 


-727 


m' 


728 


m8 


728 


m( 


729 


m9 


-729 


m) 


730 


m: 


-730 


m* 


731 


m; 


-731 


m+ 


732 


m< 


-732 


m, 


733 


m= 


-733 


m— 


734 


m> 


-734 


m. 


735 


m? 


-735 


m/ 


736 


nO 


-736 


n s P 


737 


n1 


-737 


n! 


738 


n2 


-738 


n" 


739 


n3 


-739 


n# 


740 


n4 


-740 


n$ 


741 


n5 


-741 


n% 


742 


n6 


-742 


n& 


743 


n7 


-743 


n' 


744 


n8 


-744 


n( 


745 


n9 


-745 


n) 


746 


n: 


-746 


n* 


747 


n; 


-747 


n + 


748 


n< 


-748 


n, 


749 


n= 


-749 


n — 



Positive integer 
> 
Negative integer 



Forintegers ±704 through ±719, the first char- 
acter of the parameter is a lowercase I (ADE 108). 
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REV, SEP 1983 



G-5 



INTEGER PARAMETERS 



+ lnf 


Param 


-Int" 


Param 


750 


n> 


-750 


n. 


751 


n? 


-751 


n/ 


752 


oO 


-752 


S P 


753 


01 


-753 


o! 


754 


o2 


-754 


0" 


755 


o3 


-755 


0# 


756 


04 


-756 


0$ 


757 


05 


-757 


0% 


758 


06 


-758 


o& 


759 


07 


-759 


o' 


760 


08 


-760 


o( 


761 


09 


-761 


o) 


762 


o: 


-762 


0* 


763 


o; 


-763 


+ 


764 


o< 


-764 


0, 


765 


= 


-765 


o- 


766 


o> 


-766 


0. 


767 


0? 


-767 


0/ 


768 


pO 


-768 


p s p 


769 


P1 


-769 


P! 


770 


P2 


-770 


p" 


771 


p3 


-771 


p# 


772 


P4 


-772 


p$ 


773 


p5 


-773 


p% 


774 


p6 


-774 


p& 


775 


P7 


-775 


p' 


776 


p8 


-776 


p( 


777 


p9 


-777 


p) 


778 


P= 


-778 


p* 


779 


p; 


-779 


p+ 


780 


P< 


-780 


p. 


781 


P = 


-781 


p- 


782 


P> 


-782 


p- 


783 


P? 


-783 


p/ 


784 


qO 


-784 


q s p 


785 


q1 


-785 


q! 


786 


q2 


-786 


q" 


787 


q3 


-787 


q# 


788 


q4 


-788 


qS 


789 


q5 


-789 


q% 


790 


q6 


-790 


q& 


791 


Q7 


-791 


q' 


792 


q8 


-792 


q( 


793 


q9 


-793 


q) 


794 


q= 


-794 


q* 


795 


q; 


-795 


q+ 


796 


q< 


-796 


q. 


797 


q= 


-797 


q- 


798 


q> 


-798 


q- 


799 


q? 


-799 


q/ 



Table G-1 (cont) 
INTEGER PARAMETERS 



+ lnf 


Param 


-lnt b 


Param 


800 


rO 


-800 


r s P 


801 


r1 


-801 


r! 


802 


r2 


-802 


r" 


803 


r3 


-803 


r# 


804 


r4 


-804 


r$ 


805 


r5 


-805 


r% 


806 


r6 


-806 


r& 


807 


r7 


-807 


r' 


808 


r8 


-808 


r( 


809 


r9 


-809 


r) 


810 


r: 


-810 


r* 


811 


r; 


-811 


r+ 


812 


r< 


812 


r, 


813 


r= 


813 


r— 


814 


r> 


-814 


r. 


815 


r? 


-815 


r/ 


816 


50 


-816 


S S P 


817 


s1 


-817 


s! 


818 


s2 


-818 


s" 


819 


S3 


-819 


s# 


820 


s4 


-820 


s$ 


821 


s5 


-821 


s% 


822 


s6 


-822 


s& 


823 


s7 


-823 


s' 


824 


s8 


-824 


s( 


825 


s9 


-825 


s) 


826 


s: 


-826 


s* 


827 


s; 


-827 


s+ 


828 


s< 


-828 


s, 


829 


s= 


-829 


s— 


830 


s> 


-830 


s. 


831 


s? 


-831 


s/ 


832 


to 


-832 


t s p 


833 


t1 


-833 


t! 


834 


t2 


-834 


t" 


835 


t3 


-835 


t# 


836 


t4 


-836 


t$ 


837 


t5 


-837 


t% 


838 


t6 


-838 


t& 


839 


t7 


-839 


t' 


840 


t8 


-840 


K 


841 


t9 


-841 


t) 


842 


t: 


-842 


t* 


843 


t; 


-843 


t+ 


844 


t< 


-844 


t, 


845 


t= 


-845 


t- 


846 


t> 


-846 


t. 


847 


t? 


-847 


t/ 


848 


uO 


-848 


U S P 


849 


u1 


-849 


u! 



+ lnt* 


Param 


-Int" 


Param 


850 


u2 


-850 


u" 


851 


u3 


-851 


u# 


852 


u4 


852 


u$ 


853 


u5 


-853 


u% 


854 


u6 


-854 


u& 


855 


u7 


-855 


u' 


856 


u8 


-856 


u( 


857 


u9 


-857 


u) 


858 


u: 


-858 


u* 


859 


u; 


-859 


u + 


860 


u< 


-860 


u, 


861 


u= 


-861 


ti- 


862 


u> 


-862 


ll. 


863 


u? 


-863 


u/ 


864 


vO 


-864 


V S P 


865 


v1 


-865 


v! 


866 


v2 


-866 


v" 


867 


v3 


-867 


v# 


868 


v4 


-868 


v$ 


869 


v5 


-869 


v% 


870 


v6 


-870 


v& 


871 


v7 


-871 


V' 


872 


v8 


-872 


v( 


873 


v9 


-873 


v) 


874 


v: 


-874 


V* 


875 


v; 


-875 


v + 


876 


v< 


-876 


v, 


877 


v= 


-877 


v — 


878 


v> 


-878 


V. 


879 


V? 


-879 


v/ 


880 


wO 


-880 


W S P 


881 


w1 


-881 


w! 


882 


w2 


-882 


w" 


883 


w3 


-883 


w# 


884 


w4 


884 


w$ 


885 


w5 


-885 


w% 


886 


w6 


-886 


w& 


887 


w7 


-887 


w' 


888 


w8 


-888 


w( 


889 


w9 


-889 


w) 


890 


w: 


-890 


w* 


891 


w; 


-891 


w+ 


892 


w< 


-892 


w, 


893 


w= 


-893 


w- 


894 


w> 


-894 


w. 


895 


w? 


-895 


w/ 


896 


xO 


-896 


X S P 


897 


x1 


-897 


x! 


898 


x2 


-898 


X" 


899 


x3 


-899 


x# 



Positive integer 
Negative integer 
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Table G-1 (cont) 
INTEGER PARAMETERS 



+ lnf 


Param 


-Int" 


Param 


900 


x4 


-900 


x$ 


901 


x5 


-901 


x% 


902 


x6 


-902 


x& 


903 


x7 


-903 


X' 


904 


x8 


-904 


x< 


905 


x9 


-905 


x) 


906 


x: 


-906 


X* 


907 


x; 


-907 


w_j_ 


908 


x< 


-908 


x, 


909 


x= 


-909 


x— 


910 


x> 


-910 


X. 


911 


x? 


-911 


x/ 


912 


yO 


-912 


ySp 


913 


yi 


-913 


y! 


914 


y2 


-914 


y" 


915 


y3 


-915 


y# 


916 


y4 


-916 


y$ 


917 


y5 


-917 


y% 


918 


y6 


-918 


y& 


919 


V7 


-919 


V' 


920 


y8 


-920 


y( 


921 


y9 


-921 


y) 


922 


y: 


-922 


y* 


923 


y; 


-923 


y+ 


924 


y< 


-924 


y, 


925 


y= 


-925 


y- 


926 


y> 


-926 


y- 


927 


y? 


-927 


y/ 


928 


zO 


-928 


Z S P 


929 


z1 


-929 


z! 


930 


z2 


-930 


z" 


931 


z3 


-931 


z# 


932 


z4 


-932 


z$ 


933 


z5 


-933 


z% 


934 


z6 


-934 


z& 


935 


z7 


-935 


z' 


936 


z8 


-936 


z( 


937 


z9 


-937 


z) 


938 


z: 


-938 


z* 


939 


z; 


-939 


z+ 


940 


z< 


-940 


z, 


941 


z = 


-941 


z — 


942 


z> 


-942 


z. 


943 


z? 


-943 


z/ 


944 


{0 


-944 


fSp 


945 


{1 


-945 


{! 


946 


{2 


-946 


{" 


947 


{3 


-947 


{# 


948 


{4 


-948 


{$ 


949 


{5 


-949 


{% 



+ lnt a 


Param 


-Int' 


Param 


950 


{6 


-950 


!& 


951 


S7 


-951 


I' 


952 


{8 


952 


{( 


953 


{9 


-953 


{) 


954 


{: 


-954 


r 


955 


{; 


-955 


{+ 


956 


{< 


-956 


{. 


957 


( 


-957 


f~ 


958 


i> 


-958 


{■ 


959 


i? 


-959 


{/ 


960 


b 


-960 


Pp 


961 


h 


-961 


l! 


962 


l2 


962 


I" 


963 


b 


-963 


l# 


964 


k 


-964 


\$ 


965 


Is 


-965 


l% 


966 


te 


-966 


l& 


967 


\7 


-967 


r 


968 


Is 


-968 


k 


969 


b 


-969 


i) 


970 


I: 


-970 


i* 


971 


I; 


-971 


i+ 


972 


l< 


-972 


L 


973 


I- 


-973 


i- 


974 


l> 


-974 


i. 


975 


I? 


-975 


i/ 


976 


}0 


-976 


i s p 


977 


}1 


-977 


}! 


978 


}2 


-978 


!" 


979 


}3 


-979 


]# 


980 


}4 


-980 


1$ 


981 


}5 


-981 


1% 


982 


}6 


-982 


}& 


983 


}7 


-983 


V 


984 


}8 


-984 


H 


985 


}9 


-985 


I) 


986 


}: 


-986 


r 


987 


}; 


-987 


}+ 


988 


}< 


-988 


}. 


989 


j = 


-989 


}- 


990 


!> 


-990 


}■ 


991 


}? 


991 


}/ 


992 


~0 


-992 


~ s p 


993 


~1 


-993 


~! 


994 


~2 


-994 


*> " 


995 


~3 


-995 


~# 


996 


~4 


-996 


~$ 


997 


~5 


-997 


~% 


998 


~6 


-998 


~& 


999 


~7 


-999 


~' 



+ lnt a 


Param 


-Int" 


Param 


1000 


•> 


-1000 


~( 


1001 


~9 


-1001 


~) 


1002 


~: 


-1002 


~ * 


1003 


~ J 


-1003 


~ + 


1004 


~< 


-1004 


~ y 


1005 


~ = 


-1005 


— 


1006 


~> 


-1006 


~, 


i \J\JI 


~? 


-1008 


~i 


1008 


d t0 


-1008 


D T S p 


1009 


D T1 


-1009 


Dt! 


1010 


d t2 


-1010 


D T " 


1011 


d t3 


-1011 


D T# 


1012 


D T4 


-1012 


D T$ 


1013 


d t5 


-1013 


°T% 


1014 


d t6 


-1014 


D T& 


1015 


D T7 


-1015 


D T > 


1016 


d t8 


-1016 


°T( 


1017 


d t9 


-1017 


°T) 


1018 


d t: 


-1018 


D T » 


1019 


d t; 


-1019 


DT + 


1020 


d t< 


-1020 


°T, 


1021 


D T = 


-1021 


D T - 


1022 


D T> 


-1022 


»T. 


1023 


D T? 


-1023 


°T/ 


1024 


A@0 


-1024 


A@ s p 


1025 


A@1 


-1025 


A@! 


1026 


A@2 


-1026 


A@" 


1027 


A@3 


-1027 


A@# 


1028 


A@4 


-1028 


A@$ 


1029 


A@5 


-1029 


A@% 


1030 


A@6 


-1030 


A@& 


1031 


A@7 


-1031 


A@' 


1032 


A@8 


-1032 


A@( 


1033 


A@9 


-1033 


A@) 


1034 


A@: 


-1034 


A@* 


1035 


A@; 


-1035 


A@ + 


1036 


A@< 


-1036 


A@, 


1037 


A@ = 


-1037 


A@- 


1038 


A@> 


-1038 


A@. 


1039 


A@? 


-1039 


A@/ 


1040 


AAO 


-1040 


AA s p 


1041 


AA1 


-1041 


AA! 


1042 


AA2 


-1042 


AA" 


1043 


AA3 


-1043 


AA# 


1044 


AA4 


-1044 


AA$ 


1045 


AA5 


-1045 


AA% 


1046 


AA6 


-1046 


AA& 


1047 


AA7 


-1047 


AA' 


1048 


AA8 


-1048 


AA( 


1049 


AA9 


-1049 


AA) 



Positive integer 
Negative integer 



For integers ±960 through ±975, the first char- 
acter of the parameter is a vertical bar (A DE 124.). 



4105 PROGRAMMERS 



REV, SEP 1983 



G-7 



INDEX 



Note: Entries shown in all uppercase letters are command names. 



Addresses 

column, 4-1 

row, 4-1 
Alpha cursor, 5-33 
Alpha mode, 3-2, 5-17 
Alphatext, 3-2 

font, 5-33, 4-17 
Alternate character sets, B-1 
Alternate Keypad mode, 4-3 

entering, 4-26 

exiting, 4-27 
Alternate Keypad mode programming codes, 4-26 
ALU mode, 3-12 

ALU-mode parameter, 5-7 
ANSI commands 

b l (Bell character), 4-8 

B s (Backspace character), 4-8 

CBT (Cursor Backward Tab), 4-8 

CHT (Cursor Horizontal Tab), 4-8 

c n (Cancel character), 4-8 

CPR (Cursor Position Report), 4-8 

c r (Carriage Return character), 4-8 

CUB (Cursor Backward), 4-9 

CUD (Cursor Down), 4-9 

CUF (Cursor Forward), 4-9 

CUP (Cursor Position), 4-9 

CUU (Cursor Up), 4-10 

DA (Device Attributes), 4-10 

DCH (Delete Character), 4-10 

DL (Delete Line), 4-10 

DMI (Disable Manual Input), 4-1 1 

L-»on ^ucviuc olcuuo nepui ty, ■+- i i 

ECH (Erase Character), 4-1 1 

ED (Erase in Display), 4-1 1 

EL (Erase in Line), 4-1 2 

EMI (Enable Manual Input), 4-12 

f f (Formfeed character), 4-12 

h t (Horizontal Tab character), 4-1 2 

HTS (Horizontal Tab Set), 4-1 2 

HVP (Horizontal and Vertical Position), 4-12 

ICH (Insert Character), 4-1 3 

IL (Insert Line), 4-1 3 

IND (Index), 4-13 

l f Linefeed character), 4-13 

NEL(Next Line), 4-13 

REPORT SYNTAX MODE, 4-1 4 



ANSI commands (cont) 
Rl (Reverse Index), 4-14 
RIS (Return to Initial State), 4-14 
RM (Reset Mode), 4-14 
SCS (Select Character Set), 4-1 7 
SD (Scroll Down), 4-17 
SELECT CODE, 4-18 
SGR (Select Graphic Rendition), 4-18 
s i (Shift In character), 4-20 

oi- (ourOn Lett), 4-^u 

SM (Set Mode), 4-20 

s o (Shift Out character), 4-20 

s p (Space character), 4-20 

SR (Scroll Right), 4-21 

SU (Scroll Up), 4-21 

TBC (Tab Clear), 4-21 

TEKDHL (Double Height Line), 4-22 

TEKDWL (Double Width Line), 4-22 

TEKID (Identify Terminal), 4-22 

TEKKPAM (Keypad Application Mode), 4-23 

TEKKPNM (Keypad Numeric Mode), 4-23 

TEKRC (Restore Cursor), 4-23 

TEKSC (Save Cursor), 4-24 

TEKSTBM (Set Top and Bottom Margins), 4-24 

TEKSWL (Single Width Line), 4-24 

v t (Vertical Tab character), 4-24 

(Underscore character), 4-24 

ANSI commands 

in dialog area, 4-4 
Ansi mode, 4-2, 1-3 

commands, 4-6, 4-8 - 4-24 

commanu conveniens, ■+-/ 

entering, 4-18, 4-26, 5-32 
ANSI X3.64, 1-3,4-1,4-6 
Application program codes, 4-15, 4-16 
ASCII character set, 4-17, B-1 
ASCII chart, A-1 
Aspect ratio, 3-4 

Asynchronous serial data communications, 2-2 
Attributes 

hardcopies, 5-39 

lines, 3-6 
Autorepeat mode, 4-3, 4-16 
Autowrap mode, 4-3, 4-1 6 



ANSI command 
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4100 command 
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EMI (Enable Manual Input) 1 , 4-12 
Emulating a 4010 Series terminal, 3-2, 5-14 
ENABLE DIALOG AREA 3 , 5-14, 3-2, 3-3 
ENABLE KEY EXPANSION 3 , 5-15, 3-10 
Enable Manual Input (EMI), 4-12 
ENABLE 4010 GIN 3 , 5-16 
End-of-file string, 5-41 
End-of-line string, 5-41 , 2-4 - 2-5 
End-of-message characters, 5-41 , 2-4 - 2-5 
ENDPANEL 3 , 5-17, 3-7 
ENTER ALPHA MODE 3 , 5-1 7 
ENTER ALTERNATE KEYPAD MODE 2 , 4-26 
ENTER ANSI MODE 2 , 4-26 
ENTER BYPASS MODE 3 , 5-18 
bypass-cancel character, 2-2, 5-34 
Bypass mode, 2-6, 3-10 
ENTER GRAPHICS MODE 2 , 4-27 
ENTER MARKER MODE 3 , 5-18, 3-6. See also Markers. 
ENTER VECTOR MODE 3 , 5-18, 3-5 
EOF String, 5-41 
EOL string, 5-41 , 2-4 - 2-5 
EOM characters, 5-41 , 2-4 - 2-5 
EOM-indicator, 5-27, 5-28 
Erase Character (ECH)\ 4-1 1 
Erase in Display (ED)',4-1 1 
Erase index, 4-18, 4-19 
Erase in Line (EL)', 4-12 
ERASE TO END OF LINE 2 , 4-27 
ERASE TO END OF SCREEN 2 , 4-27 
Erasure commands, ANSI 
ECH (Erase Character), 4-1 1 
ED (Erase in Display), 4-1 1 
EL (Erase in Line), 4-12 
Erasure commands, VT52 
ERASE TO END OF LINE, 4-27 
ERASE TO END OF SCREEN, 4-27 
Error codes, C-1 
Errors 
error codes, C-1 

Error Message Report, 2-6, 5-26 
REPORT ERRORS, 5-26 
SET ERROR THRESHOLD, 5-42 
Escape sequence, 5-6 
EXIT ALTERNATE KEYPAD MODE 2 , 4-27 
EXIT GRAPHICS MODE 2 , 4-27 
EXPAND MACRO 3 , 5-18. See also Macros. 
Expanding a macro, 3-10 



ANSI command 
VT52 command 
41 00 command 



FACTORY 3 , 5-19 

Factory default color indices, 5-37 

Factory defaults, 4-7, 5-6 

Features, 1-1 

f f (Formfeed character)', 4-1 2 

Fill patterns, 3-7, 3-9, 5-32 

dither patterns, 3-9 
Fixed regions, 4-3 - 4-5 
Flagging, 2-4 

SET FLAGGING MODE, 5-42 
Formfeed character ( f f)' ,4-12 
Formfeeds (for hardcopies), 5-39 
Foreground index, 4-18, 4-19 
French character set, 4-17, B-2 

German character set, 4-17, B-4 
GIN. See Graphics Input. 
GRAPHIC TEXT 3 , 5-19, 3-7 
Graphics 

color, 3-8 - 3-9 

defined, 3-1 

graphtext, 3-7 

lines, 3-5 

markers, 3-6 

panels, 3-7 
Graphics area, 3-1 . See also Graphics. 

SET GRAPHICS AREA WRITING MODE, 5-43 
Graphics cursor 

color, 5-42 

ENABLE 4010 GIN, 5-1 6 

position, 5-48 

report, 2-5, 5-16 

speed, 5-43 
Graphics Input, 3-9 

ENABLE 4010 GIN, 5-16 
Graphics mode, 4-3 
Graphics position, 3-4 
Graphtext, 3-7 

character path, 5-34 

rotation, 5-44 

size, 5-44 

Hardcopies 
CANCEL, 5-8 
COPY, 5-9 
HARDCOPY5-19 

SELECT HARDCOPY INTERFACE, 5-32 
SET COPY SIZE, 5-36 

SET DIALOG HARDCOPY ATTRIBUTES, 5-39 
4010 HARDCOPY, 5-53 
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HARDCOPY 3 , 5-19 

HELP 3 , 5-19 

Home, 3-4, 5-22 

Horizontal Tab character ( h t)\ 4-12 

Horizontal Tab Set (HTS) 1 , 4-12 

Host syntax, 4-7, 5-6 

character arrays, 5-1 

integer array parameters, 5-3 

integer parameters, 5-2 

integer report parameters, 5-3 

xy-coordinates, 5-4 
h t (Horizontal Tab character) 1 , 4-1 2 
HTS (Horizontal Tab Set) 1 , 4-12 
HVP (Horizontal and Vertical Position) 1 , 4-12 

ICH (Insert character) 1 , 4-13 

IDENTIFY 2 , 4-27 

Identify Terminal (TEKID) 1 , 4-22 

IGNORE DELETES 3 , 5-20, 2-3, 5-5 

IL (Insert Line) 1 , 4-1 3 

IND (Index) 1 , 4-13 

Index (IND) 1 , 4-13 

Indices (color), 3-8, 3-12 

SET DIALOG AREA INDEX, 5-37 

SET TEXT INDEX, 5-50 
Initial state, 4-14 
Input queue, 2-3 

CANCEL, 5-8 

flagging, 2-4 

handshaking, 2-3 

Prompt mode, 2-4 

SET QUEUE SIZE, 5-48 
Inquiry codes, 5-27 
Insert Character (ICH) 1 , 4-13 
Insert Line (IL) 1 , 4-13 
Insert/Replace mode, 4-3, 4-15 
Insertion commands, ANSI 

ICH (Insert Character), 4-13 

IL (Insert Line), 4-13 
Integer parameters 

examples, G-1 

in arrays, 5-3 

in Host syntax, 5-2 

in reports, 5-3 

in Setup syntax, 4-7, 5-3 
Integers 

in parameters, 4-7 
Inverted image, 5-23 
ISO 6429, 1-3,4-1 



Joydisk, 3-9,5-3, 5-16,5-43 

Key definitions. See Macros. 
Key-execute characters, 3-1 1,5-11 

local macros, 3-1 1 

SET KEY EXECUTE CHARACTER, 5-45 
Key expansion, 5-15,3-10 
Key macros, 3-10, 5-11 
Key specifiers, 5-3 
Keyboard, 1-2 

Disable Manual Input (DMI), 4-1 1 

kUllon.iollnnnWPMn A-19 

LOCK KEYBOARD, 5-21 
Keypad Application Mode (TEKKPAM) 1 , 4-23 
Keypad mode, 4-3, 4-26 

Application, 4-23 

Numeric, 4-23 

programming codes, 4-23 

LEARN 3 , 5-20, 3-1 1 

l l (Linefeed character) 1 , 4-1 3 

LFCR 3 , 5-21 

Line index, 5-45, 3-6 

Linefeed character ( l f) 1 , 4-13 

Linefeed/Newline mode, 4-3, 4-15 

Line style codes, 5-52 

Lines, 3-5 

attributes, 3-6 

DRAW, 3-5,5-13 

double height, 4-22 

double width, 4-22 

ENTER VECTOR MODE, 5-1 8 

line index, 3-6, 5-45 

line st w !e 3-6 5-46 

MOVE, 3-5, 5-22 

SET LINE INDEX, 5-45 

SET LINE STYLE, 5-46 

single width, 4-24 

Vector mode, 3-5 
Literal character, 5-41 , 5-10 
LOCAL 3 , 5-21 
Local mode, 5-21 
LOCK KEYBOARD 3 , 5-21 
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Macro numbers, 3-10,5-11-5-12 
MACRO STATUS 3 , 5-21 . See also Macros. 
Macros, 3-10-3-11 
DEFINE MACRO, 5-10 
DEFINE NONVOLATILE MACRO, 5-13 
ENABLE KEY EXPANSION, 3-1 1 
EXPAND MACRO, 5-13 
host macros, 3-1 
key macros, 3-10 
key specifiers, 5-3 
LEARN, 5-20 
local key macros, 3-1 1 
NVLEARN, 5-20 
Major modes 
Ansi, 1-3, 4-2, 4-4 
Edit, 4-2 - 4-3 
Tek, 1-3-1-4,4-2 
VT52, 1-3-1-4,4-2 
Manuals, 1-1 
Margins 
edit, 4-4, 4-26 

TEKSTBM (Set Top and Bottom Margins), 4-24 
Markers, 3-6 

DRAW MARKER, 3-6, 5-14 
ENTER MARKER MODE, 3-6, 5-18 
Marker mode, 3-6 
SET MARKER TYPE, 5-46 
types, 5-46 
Memory 
dialog buffer, 4-4 

nonvolatile parameters, 3-1 1 , 5-31 
off-screen, 3-1 2 
raster, 3-12 
Mirror image, 5-23 

Mode setting and resetting, 4-1 4 - 4-1 6, 4-20 
Model number (terminal), 5-27 
Modes, 1-3-1-4,4-2-4-3 
Alpha, 5-17, 3-2 
Alternate Keypad, 4-3, 
Ansi, 1-3,4-2,4-4 
Autorepeat, 4-3, 4-16 
Autowrap, 4-3, 4-1 6 
Bypass, 2-6, 5-18 
Column, 4-3, 4-15 
Cursor Key, 4-3, 4-15 
Edit, 4-2, 4-3 
Graphics, 4-3 
Insert/Replace, 4-3, 4-15 
Keypad, 4-3 
Linefeed/Newline, 4-3, 4-15 



Modes (cont) 

Origin, 4-3, 4-16 

Overstrike/Repace, 4-3, 4-15 

Screen, 4-3, 4-16 

Setup, 1-3-1-4, 4-2 

Send/Receive, 4-15 

Snoopy, 5-49 

Tek, 1-3-1-4, 4-2 

VT52, 1-3-1-4,4-2 
Monochrome copies, 5-32 
MOVE 3 , 5-22, 3-5 

NEL(Next Line)', 4-13 
Next Line (NEL)', 4-13 
Nonvolatile macro, 3-1 1,5-11 

DEFINE NONVOLATILE MACRO, 3-1 1,5-13 

SAVE NONVOLATILE PARAMETERS, 3-1 1 , 5-31 
Normal display, 4-1 
Norwegian character set, 4-17, B-3 
Numeric keypad, 4-3, 4-26 

mode, 4-23 

programming codes, 4-23 
NVLEARN 3 , 5-20, 3-11 

Off-screen memory, 3-12 
Omitted defaults, 4-7, 5-6 
Option 30 Pixel ROMs, 3-12-3-15 
Origin mode, 4-3, 4-16 
Overstrike/Replace mode, 4-3, 4-15 

PAGE 3 , 5-22 

Panel fill patterns, 3-7, 3-9, 5-32 

Panels, 3-7 

BEGIN PANEL BOUNDARY, 5-7 

END PANEL, 5-17 

fill patterns, 3-7, 3-9, 5-32 

SELECT FILL PATTERN, 5-32 
Parameter defaults, D-1 
Parameter types, 5-1 - 5-5 

character arrays, 5-1 

characters, 5-1 

integer arrays, 5-2 

integer reports, 5-3 

integers (Host), 5-2 

integers (Setup), 5-3 

key specifiers, 5-3 

keywords, 5-4 

small integers, 5-1 

strings, 5-1 

xy-coordi nates, 5-4 - 5-5 
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Parameter values (current), 5-53 

Parameters for setting and resetting modes, 4-1 5-4-16 

Periods, 5-6 

Parity, 2-2 

SET PARITY, 5-47 
Parity bits, 2-2 
Pixel beam, 5-47 
PIXEL COPY 3 , 5-22, 3-12 
Pixel operations, 3-1 2-3-15 

BEGIN PIXEL OPERATIONS, 3-12, 5-7 

PIXEL COPY, 3-1 3-3-15, 5-22 

RASTER WRITE, 3-13 - 3-15, 5-24 

RECTANGLE FILL, 3-13-3-15, 5-26 

RUNLENGTH WRITE, 3-1 3-3-15, 5-31 

SET PIXEL BEAM POSITION, 3-13, 5-47 

SET PIXEL VIEWPORT, 3-13, 5-47 
Pixel viewport, 3-13 
Power-up condition, 4-14 
Printing characters, 5-1 , A-1 
Programming keys, 3-1 0-3-11 
Programming model, 1-3 
PROMPT MODE 3 , 5-23, 2-4 
Prompt mode, 2-4, 5-23, 5-48 
PXBEGIN 3 , 3-13, 5-7 
PXPOSITION 3 ,3-14,5-47 
PXRASTERWRITE 3 , 3-13 - 3-15, 5-24 
PXRECTANGLE 3 , 3-13, 5-26 
PXRUNLENGTHWRITE 3 , 3-14 - 3-15, 5-31 
PXVIEWPORT 3 , 3-13, 5-47 

\ 
Queues. See Input queues; Output queues. 

Raster memory, 3-1 2 
RASTERWRITE 3 , 5-24, 3-13 - 3-14 
Receive rates, 2-1 

SET BAUD RATES, 5-33 
RECTANGLE FILL 3 , 5-26, 3-13 
REPORT ERRORS 3 , 5-26 

Error Message Report, 5-26 
REPORT SYNTAX MODE 1 ' 3 , 4-14, 5-27 
REPORT TERMINAL SETTINGS 3 , 5-27 
REPORT 4010 STATUS 3 , 5-29 
Reports 

commands, 2-5 

Cursor Position, 5-30 

Device Status, 4-1 1 

Dialog Area Color Map, 5-28 

Error Message, 5-26 

inquiry codes, 5-27 



Reports (cont) 

requesting, 2-5 

Surface Color Map, 5-29 

Terminal Settings, 5-28 

4010 GIN, 5-16 

4010 Status, 5-29 
Reset Mode (RM) 1 , 4-14 

RM parameters, 4-15-4-16 
Reset to Initial State (RIS)', 4-14 
Restore Cursor (RC) 1 , 4-23 
Reverse Index (Rl) 1 , 4-14 
REVERSE LINEFEED 2 , 4-27 
Reverse video display, 4-1 ,4-19 
Rl (Reverse Index) 1 , 4-14 
RIS (Reset to Initial State) 1 , 4-14 
RM (Reset Mode) 1 , 4-14 
Rotating characters, 5-44, 5-34 
Row address, 4-1 
Rubout characters, 2-3 
Ruling character set, 4-17, B-5 
Runcodes, 3-14, 5-31 
RUNLENGTH WRITE 3 , 5-31 ,3-14- 



15 



Save Cursor (SC) 1 , 4-24 

SAVE NONVOLATILE PARAMETERS 3 , 5-31 , 2-3, 3-2, 3-8, 3-1 1 

Saving parameters, 3-1 1 , 5-31 

Screen editing, 4-1 - 4-27 

concepts, 4-1 - 4-6 

features, 4-1 

modes, 4-2 - 4-3 
Screen mode, 4-3, 4-16 
Scroll Down (SD) 1 , 4-17 
Scroll Left (SL) 1 , 4-20 
Scroll Right (SR) 1 , 4-21 
Scroll Up (SU) 1 , 4-21 
Scrolling regions, 4-3 - 4-5 

edit margins, 4-4, 4-24 
Scrolling, 5-8, 3-2 

SD (Scroll Down), 4-17 

SL (Scroll Left), 4-20 

SR (Scroll Right), 4-21 

SU (Scroll Up), 4-21 
SCS (Select Character Set) 1 ,4-17 
Segment position, 5-48 
Select Character Set (SCS) 1 , 4-17 
SELECT CODE 1 3 , 4-18, 5-32 
SELECT FILL PATTERN 3 , 5-32, 3-7, 3-9 
Select Graphic Rendition (SGR) 1 , 4-18 
SELECT HARDCOPY INTERFACE 3 , 5-32. See also 
Hardcopies. 
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Semicolons 

in syntax, 4-7 
Send/Receive mode, 4-15 
SET ALPHA CURSOR INDEX 3 , 5-33 
SET ALPHA TEXT FONT 3 , 5-33, 3-2, 4-17 
SET BAUD RATES 3 , 5-33, 2-1 
SET BREAK TIME 3 , 5-34, 2-2 
SET BYPASS CANCEL CHARACTER 1 , 5-34, 2-6 
SET CHARACTER PATH 3 , 5-34. See also Graphtext. 
SET COPY SIZE 3 , 5-36. See also Hardcopies. 
SET DIALOG AREA BUFFER SIZE 3 , 5-36, 3-2 
SET DIALOG AREA COLOR MAP 3 , 5-36, 3-3 
SET DIALOG AREA INDEX 3 , 5-37, 3-3 
SET DIALOG AREA LINES 3 , 5-38, 3-3 
SET DIALOG AREA WRITING MODE 3 , 5-39, 3-3 
SET DIALOG HARDCOPY ATTRIBUTES 3 , 5-39. See also 

Hardcopies. 
SET ECHO 3 , 5-40, 2-1 
SET EDIT CHARS 3 , 5-40 
SET EOF STRING 3 , 5-41 
SET EOL STRING 3 , 5-41 , 2-4 - 2-5 
SET EOM CHARACTERS 3 , 5-41 , 2-4 - 2-5 
SET ERROR THRESHOLD 3 , 5-42. See also Errors. 
SET FLAGGING MODE 3 , 5-42, 2-4 
SET GIN CURSOR COLOR 3 , 5-42 
SET GIN CURSOR SPEED 3 , 5-43 
SET GRAPHICS AREA WRITING MODE 3 , 5-43 
SET GRAPHTEXT ROTATION 3 , 5-44. See also Graphtext. 
SET GRAPHTEXT SIZE 3 , 5-44. See also Graphtext. 
SET KEY EXECUTE CHARACTER 3 , 5-45, 3-1 1 
SET LINE INDEX 3 , 5-45, 3-6. See also Lines. 
SET LINE STYLE 3 , 5-46, 3-6. See also Lines. 
SET MARKER TYPE 3 , 5-46, 3-6. See also Markers. 
Set Mode (SM) 1 , 4-20 

Set Mode parameters, 4-1 5-4-16 
SET PARITY 3 , 5-47, 2-2 

SET PIXEL BEAM POSITION 3 , 5-47, 3-1 2-3-15 
SET PIXEL VIEWPORT 3 , 5-47, 3-12-3-15 
SET PROMPT STRING 3 , 5-48. See also Prompt mode. 
SET QUEUE SIZE 3 , 5-48. See also Input queue. 
SET SEGMENT POSITION 3 , 5-48 
SET SNOOPY MODE 3 , 5-49 
SET STOPBITS 3 , 5-49, 2-2 
SET SURFACE COLOR MAP 3 , 5-49 
SET TAB STOPS 3 , 5-50 
SET TEXT INDEX 3 , 5-50. See also Color. 
SET TRANSMIT DELAY 3 , 5-51 , 2-5 
SET TRANSMIT RATE LIMIT 3 , 5-51 , 2-1 
SET VIEW ATTRIBUTES 3 , 5-51 
SET WINDOW 3 , 5-52, 3-4 
SET 4014 LINE STYLE 3 , 5-52 



Setup command names 
ACURSOR, 5-33 
AUTOREPEAT, 4-16 
AUTOWRAR4-16 
BAUDRATE, 5-33, 2-1 
BEGINPANEL, 5-7, 3-7 
BREAKTIME, 5-34, 2-2 
BYPASSCANCEL, 5-34, 
CANCEL, 5-8 
CLEARDIALOG, 5-8 
CMAR 5-49, 8-8 
CODE, 4-18, 5-32 
COLUMNMODE.4-15 
COPY, 5-9 
CRLF,5-10 

CURSORKEYMODE, 4-1 5 
DABUFFER, 5-36, 3-3 
DACMAR 5-36, 3-3 
DAENABLE, 5-14, 3-3 
DAINDEX, 5-37, 3-3 
DALINES, 5-38, 3-3 
DAMODE, 4-15, 5-39, 3-3 
DAVISIBILITY, 5-39, 3-3 
DEFINE, 5-10, 3-10-3-11 
DRAW, 5-1 3, 3-5 
ECHO, 5-40, 2-1 
EDITCHARS, 5-40 
EDITMARGINS, 4-24, 4-4 
ENDPANEL, 5-17,3-7 
EOFSTRING.5-41 
EOLSTRING, 5-41 , 2-4 - 2-5 
EOMCHARS, 5-41 , 2-4 - 2-5 
ERRORLEVEL, 5-42 
EXPAND, 5-18, 3-10 
FACTORY, 5-19 
FILLPATTERN, 5-32, 3-9 
FLAGGING, 5-42, 2-4 
GAMODE, 5-43 
GCURSOR, 5-42 
GSPEED, 5-43 
GTEXT, 5-19 
GTINDEX, 5-50 
GTPATH, 5-34 
GTROTATION, 5-44 
GTSIZE, 5-44 
HCDAATTRIBUTES, 5-39 
HCINTERFACE, 5-32 
HCSIZE, 5-36 
HELP, 5-19 

IGNOREDEL, 5-20, 2-3 
KEYEXCHAR, 5-45, 3-11 
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Setup command names (cont) 

KEYEXPAND, 5-15, 3-10 

KEYPADMODE, 4-23 

LEARN, 5-20, 3-11 

LFCR, 5-21 

LINEINDEX, 5-45, 3-6 

LINESTYLE, 5-46, 3-6 

LOCAL, 5-21 

MACROSTATUS, 5-21 

MARKER, 5-14, 3-6 

MARKERTYPE, 5-46, 3-6 

MOVE, 5-22, 3-5 

NVDEFINE,5-13,3-11 

NVLEARN, 5-20, 3-11 

NVSAVE, 5-31 

ORIGINMODE.4-16 

PARITY, 5-47, 2-2 

PXBEGIN, 5-7, 3-13 

PXCOPY, 5-22, 3-12 

PXPOSITION, 5-47, 3-14 

PXRASTERWRITE, 5-24, 3-13-3-14 

PXRECTANGLE, 5-26, 3-13 

PXRUNLENGTHWRITE, 5-31 , 3-14 - 3-15 

PXVIEWPORT, 5-47, 3-13 

PROMPTMODE, 5-23 

PROMPTSTRING,5-48 

QEUESIZE, 5-48 

SCREENMODE,4-16 

SELECTCHARSEX4-17 

SGPOSITION.5-48 

SNOOPY, 5-49 

STATUS, 5-53 

STOPBITS, 5-49 

TABS, 5-50 

TEXTRENDITION.4-18 

VIEWATTRIBUTES, 5-51 

XMTDELAY, 5-51 

WINDOW, 5-52 
Setup syntax, 4-7, 5-6 

character parameters, 5-1 

integer parameters, 4-7, 5-3 

key specifiers, 5-3 

keywords, 5-4 

small integer parameters, 5-1 

string parameters, 5-1 
SGR (Select Graphic Rendition) 1 , 4-18 
Shift In character ( s i)\ 4-20 
Shift Out character ( s o)', 4-20 
s i (Shift In character)', 4-20 
Single Width Line (TEKSWL) 1 , 4-24 



SL (Scroll Left) 1 ,4-20 

SM (Set Mode)', 4-20 

Snoopy mode, 5-49 

s o (Shift Out character) 1 , 4-20 

s p (Space character) 1 , 4-20 

Space character ( s p) 1 , 4-20 

Spaces 

in syntax, 4-7, 5-6 
Special inquiry codes, 5-27 
SR (Scroll Right) 1 , 4-21 
Standards 

ISO, 1-3,4-1 

ANSI, 1-3,4-1,4-6 
STATUS 3 , 5-53 
Stop bits, 2-2 

SET STOP BITS, 5-49 
String parameters, 4-7, 5-1 
SU (Scroll Up) 1 , 4-21 
Supplementary character set, 4-17, B-4 
Surfaces 

SET SURFACE COLOR MAP, 5-49 

surface number, 5-7 
Swedish character set, 4-17, B-3 
Syntax conventions 

Ansi mode, 4-7 

bold type, 4-7, 5-6 

commas, 4-7, 5-6 

ellipsis (periods), 5-6 

Host, 4-7, 5-6 

semicolons, 4-7 

Setup, 4-7, 5-6 

uppercase, 4-7 

VT52 mode, 4-7 

t I *J\J ^Ull iimou iub, O-D 

Syntax Mode Report, 5-27 

Tab commands, ANSI 
CBT (Cursor Backward Tab), 4-8 
CHT (Cursor Horizontal Tab), 4-8 
h t (Horizontal Tab character), 4-12 
HTS (Horizontal Tab Set), 4-12 
TBC (Tab Clear), 4-21 
v t (Vertical Tab character), 4-24 

Tab Clear (TBC) 1 , 4-21 

Tabs 
CBT (Cursor Backward Tab), 4-8 
CHT (Cursor Horizontal Tab), 4-8 
SET TAB STOPS, 5-50 

TBC (Tab Clear) 1 , 4-21 



ANSI command 
VT52 command 
41 00 command 
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Tek mode 

entering, 4-18, 5-32 
Tek-private commands 

TEKDHL (Double Height Line), 4-22 

TEKDWL (Double Width Line), 4-22 

TEKID (Identify Terminal), 4-22 

TEKKPAM (Keypad Application Mode), 4-22 

TEKKPNM (Keypad Numeric Mode), 4-23 

TEKRC (Restore Cursor), 4-23 

TEKSC (Save Cursor), 4-24 

TEKSTBM (Set Top and Bottom Margins), 4-24 

TEKSWL (Single Width Line), 4-24 
TEKDHL (Double Height Line)', 4-22 
TEKDWL (Double Width Line) 1 , 4-22 
TEKID (Identify Terminal)', 4-22 
TEKKPAM (Keypad Application Mode) 1 , 4-22 
TEKKPNM (Keypad Numeric Mode)', 4-23 
TEKRC (Restore Cursor)', 4-23 
TEKSC (Save Cursor)', 4-24 
TEKSTBM (Set Top and Bottom Margins)', 4-24 
TEKSWL (Single Width Line)', 4-24 
Terminal initialization file, 4-6 
Terminal modes. See Modes. 
Terminal Settings Report, 5-27 
Terminal space, 3-3 

xy-coordinates, 3-3 

windows, 3-4 
Terminal space units, 3-3 
Transmit rates 

delay, 2-5 

limit, 2-1 

SET BAUD RATES, 5-33 
Transparency, 3-2, 5-37 

Underscore display, 4-1 , 4-15, 4-19, 4-24 
United Kingdom character set, 4-17, B-2 



ANSI command 
VT52 command 
4100 command 



Vector mode, 3-5, 5-18 

Version (firmware), 5-27 

View attributes, 5-51 

Viewport, 3-1 3 -3-1 5, 5-47 

Visibility (dialog area), 3-2, 5-38, 5-39 

Volatile macro, 3-1 1 , 5-1 1 

v t (Vertical Tab character)', 4-24 

VT52 commands 

CURSOR DOWN, 4-25 

CURSOR LEFT, 4-25 

CURSOR RIGHT, 4-25 

CURSOR TO HOME, 4-25 

CURSOR UP, 4-25 

DIRECT CURSOR ADDRESS, 4-26 

ENTER ALTERNATE KEYPAD MODE, 4-26 

ENTER GRAPHICS MODE, 4-27 

ERASE TO END OF LINE, 4-27 

ERASE TO END OF SCREEN, 4-27 

EXIT ALTERNATE KEYPAD MODE, 4-27 

EXIT GRAPH 
VT52 mode, 1-3, 4-2, 4-3, 4-6 

commands, 4-25 - 4-27 

command conventions, 4-7 

entering, 4-15, 4-18, 5-32 
VT100,4-6 

Device Attributes command, 4-1 

Windows, 3-4 

SET WINDOW, 5-52 
Writing mode 

dialog area, 5-39 

graphics area, 5-43 

XY-coordinates 
terminal space, 3-3 

4010 GIN 3 , 5-16 

4010 HARDCOPY 3 , 5-53. See also Hardcopies. 

4010 status, 5-29 

4014 Line style, 5-52 

(Underscore character)', 4-24, 4-15 
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